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INTRODUCTION TO THE V/SCSI 4210 


OVERVIEW 


The V/SCSI 4210 Jaguar is a VMEbus SCSI host adapter capable of controlling up to 14 
SCSI devices — seven with the primary SCSI port (Port 0), plus seven more if the optional 
secondary SCSI port (Port 1) is instaUed. As an alternative, the secondary port can be used 
to output data to a printer, provided your setup includes the optional printer port daughter 
card. 

System Interface 

The host processor communicates with the Jaguar through 2 Kbytes of onboard RAM. All 
commands and responses pass through this 2K space, which is referred to as “short I/O,” 
because it is mapped into the short I/O space of the VMEbus. 

Each command to the Jaguar is specified using a host-generated software structure called an 
Input/Output Parameter Block (lOPB). lOPBs can be built in either the Jaguar’s 2K short 
I/O space or offboard in system memory. In the latter case, command completions are 
posted to both on- and offboard data structures. 

The system-level interface, referred to as “MACS!” (for Multiple Active Command Software 
Interface), is implemented in short I/O. In addition to supporting command queuing, 
MACSI enables multiple commands to be active simultaneously. The Jaguar accepts 
commands from the host and queues them internally. It then acts on each command as soon 
as possible, within the confines of the SCSI bus. As commands are completed, the host is 
notkied of each command’s completion, as well as its completion status. 

Issuing Commands 

The host submits commands to the Jaguar by making an entry into a circular queue called 
the Command Queue. Each Command Queue entry is a 12-byte block containii^ a pointer. 
to the lOPB and c^er control information. 

lOPBs may be buiU by the host either onboard (in the Jaguar’s Host Usable Space in short 
I/O), or offboard in ^^em memory. Once it builds an lOPB, the host creates an entry for 
the lOPB in the next available slot in the Command Queue. 

Executing Commands 

The Jaguar reads the Command Queue, determines which entry is to be executed next, and 
moves the appropriate Command Queue entry and lOPB into one of its internal work 
queues. The Jaguar supports up to 15 work queues, numbered 0 through 14. Work Queues 
1 -14 are each intended to be dedicated to a specific SCSI device (or to a printer connected 
via the optional printer port daughter card). Tlius, commands intended for a specific device 
are sent to the work queue dedicated to that device. 


1 




Interphase Corporation 


After the Command Queue entry and lOPB have been placed in a work queue, the slot in 
the Command Queue that was fdled by the command b^mes available for re-use by the 
host. As a result, the host virtually always has entries available in the Command Queue for 
issuing commands. This frees the host from the need to be concerned with any of the 
intimate timing issues of the Jaguar’s Command Queue. 

Even in the unlikely case that the Command Queue is full when the host tries to enter a 
command, the Jaguar provides efficient operation by optionally interrupting the host when 
an entry becomes available in the Command Queue. 

Once the command is moved into the appropriate work queue, the Jaguar executes it at the 
first opportunity. It then posts completion to the Command Response Block (located in 
either short I/O or in system memory) and generates an interrupt (if enabled to do so). 

The host acknowledges the interrupt by writing a word to the Command Response Block, 
releasing it for further use. 


Work Queues 


The concept of work queues is integral to the way that MACSI allows multiple commands to 
be active simultaneously. Information in the Command Queue entry determines the work 
queue into which a particular command is placed. At any time, there is an In Progress 
command for each work queue that has at least one entry. The Next command is simply 
waiting for the In Progress command from that work queue to complete. 

Since the SCSI bus allows many tasks to be overlapped on multiple devices, the MACSI 
interface allows for commands from all work queues to be interspersed. Assuming that the 
SCSI devices support overlapped activity on the SCSI bus (using Disconnect/Reconnect), up 
to 14 commands (one In Progress command from each attached SCSI deface) can be 
simultaneously active, resulting in overlapped data streams. Indeed, since the Jaguar has two 
fully independent SCSI buses, it can support two truly simultaneous data streams. If some 
devices do not support overlapped activity, they can be relegated to the second port, 
allowing fully funt^oning devices on the first port unrestricted operation. The second port 
can, of course, also support full SCSI functionality. 

The Jaguar accommodates up to 14 work queues, not counting a special queue called Work 
Queue 0. The h<»t fixes each work queue’s parameters when it initializes the queue. The 
host is then responsible for using the work queues in a manner consistent with the 
initialization scheme. The only restriction is that no more than one work queue can be 
allocated to a de^ce. The number of entries in the Command Queue, the number of slots 
in each work queue, the characteristics of these queues, as well as other Jaguar operating 
parameters, are pro^ammable and must be initialized before use. 

Master Command Entiy and Work Queue 0 

In order to initialize the board, as well as to execute very high priority commands, the 
Jaguar provides two auto-initialized facilities —the Master Command Entry and Work 
Queue 0. 

The Master Command Entry is a 12-byte location in short I/O which has exactly the same 
form as a Command Queue entry (le. control information and a pointer to an lOPB). It 
acts like a single-entry Command Queue. Commands issued through the Master Command 
Entry are executed immediately. 

Likewise, the Work Queue 0 is a single-slot work queue capable of accepting one CGuimand 
at a time. It is highest priority work queue, so any command sent to Work Queue 0 is 
executed immediately. Its len^ (one slot) cannot be changed by the host. 
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Work Queue 0 is defined to have a length of 1 so that only one error recovery process can 
occur at a time. However, it is possible th^ a command from Work Queue 0 may itself 
require error recovery. To deal with that situation, certain commands (specifically, SCSI Bus 
Reset and Flush Work Queue) may always be issued through Work Queue 0. For all other 
commands. Work Queue 0 has a length of 1. 

The Master Command Entry and Work Queue 0 allow you to issue a single command and 
then wait for its completion before issuing the next one. A typical use for these facilities is, 
upon power-up, to initialize the rest of the queues and start off normal SCSI operations. 

Note that the Master Command Entry and Work Queue 0 are not removed, even after the 
Command Queue and the other work queues are initialized and normal activity has begun. 


CONVENTIONS USED IN THIS MANUAL 


When numeric values are used, number base 10 may be assumed unless preceded by the 
characters “Ox” for base 16 (hexadecimal). 

Binary numbers are represented as “1” and “0”. 

“Words” are 16-bit entities. 

Signal names followed by the character “*” are active low (i.e., 0 = true, 1 = false). 
When individual bits are discussed in the text, “set” means “1” and “clear” means **0”. 

References 

ANSI X3T92 SCSI Specifications 
VMEbus Bus Specification, Revision C.1 
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V/SCSi 4210 JAGUAR 
Virtual Buffer Architecture 
with BUSpacket Interface 



VME bus 


Figure 1, V/SCSI 4210 Jaguar Block Diagram 
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INSTALLATION 


OVERVIEW 


Before attempting installation, read this chapter thoroughly to insure the safe installation of 
the Jaguar into your system. If you have any questions regarding installation which are not 
answered in this chapter, please contact Interphase Customer Service at (214) 350-9000. 

The Jaguar is installed into the VMEbus system using the following steps: 

• Visual Inspection 

• Set Onboard Jumpers 

• Set Onboard Switches 

• Set SCSI Termination 

• Power Off System 

• Cabling Procedure 

When installing the Jaguar, the following WARNING must be adhered to. 


WARNING 

1. Catastrophic DAMAGE can result if improper connections are made. Therefore, 
those planning to connect power sources to the VMEbus for the purpose of feeding 
the user-defined 96 pins ofP2 (Rows A and C) should FIRST CHECK to ensure 
that all boards installed are compatible with those connections. 

2 Do NOT install or apply power to a damaged board. Failure to observe this warning 
could result in extensive damage to the board and/or system. 

3. Caution! The Jaguar is extremely sensitive to electrostatic discharge (ESD), and the 
board could be damaged if handled improperly. Interphase ships the board enclosed 
in a special anti-static bag. Upon receipt of the board, take the proper measures to 
elintinate board damage due to ESD (ue., wear a wrist gyound strap or other 
gvuruting device). 


The installation procedure will vary depending on the desired configuration. Variables 
mclude: 

— one or two SCSI ports (7 SCSI devices per port) 

— single-ended vs. differential SCSI operation for each port 

— use of P4 connector to interface with a printer 

— front panel I/O vs. routing SCSI signals off the P2 connector (to determine the location 
of the connectors, refer to Fig. 2 or 3) 


5 




Interphase Corporation 


The following table summarizes the V/SCSI 4210 products that are available from 
Interphase to implement various combinations of the above functions. 

Table 1. V/SCSI 4210 Products 


Single-ended V/SCSI 4210 
Ja^ar Motherboard 
(Fm P2 connector) 


Provides one single-ended SCSI port whose signals can be 
routed off either P3 or P2. This board uses rows A, B, 
and C of the P2 connector. 


Single-ended V/SCSI 4210 
Jaguar Motherboard 
(Row B connector) 


Provides one sinde-ended SCSI port whose signals can be 
routed off P3. This board only uses row B offc P2 

rn nnft ftnr. 


Differential V/SCSI 4210 
J^uar Motherboard 
(F^ P2 Connector) 


Has one differential SCSI port whose signals can be routed 
off either P3 or P2. It uses rows A, B, and C of the K 
connector. 


Differential V/SCSI 4210 Has one differential SCSI port whose signals can be routed 

Jaguar Motherboard off P3. It only uses row B of the K connector. 

(Row B Connector) 


Single-ended V/SCSI 4210 
Daughter Card 


Adds one single-ended SCSI port to any of the above 
motherboards. The signals from this port may be routed off 
either P4 or P2 if the card is installea on a motherboard 
with full P2 I/O. If the card is installed on a motherboard 
that uses P2 Row B only, its signals can only be routed off 
P4, 


Differential V/SCSI 4210 
Daughter Card 


Adds one differential SCSI port to any of the above 
motherboards. If installed on a single-ended motherboard 
with full P2 I/O, this card’s signals can routed off either 
P4 or P2. Howeverjif it is installed on any differential 
motherboard (fiill K or row B only), its signals can only be 
routed off P4. (This is because there are an insufficient 
number of pins available on P2 to accommodate two 
differential SCSI ports.) 


V/SCSI 4210 Printer Port 
Daughter Cards 


Adds one printer port to any of the above motherboards. 
One variation of tnis card supports Centronics'** and 
Dataproducts Short Line printers. The other supports 
Dataproducts* Long line printers. The'signals from this 
port can only be routed off P4. 


V/SCSI 4210 P2 Adapter Card Routes SCSI signals off the P2 connector (plugs into the 

VMl^us backplane) 

NOTES: None of the drivers on the above products are convertible. That is, a board with 
single-ended SCSI drivers cannot be converted to differential, and rice versa. 
However, a single-ended motherboard can have a differential daughter card, and a 
differential motherboard can have a single-ended daughter card. 

As noted previously, the SCSI port provided by the motherboard is referred to as 
Port 0 or the primary SCSI bus. The port provided by a SCSI daughter card (if 
installed) is called the Port 1 or the sccoudaiy SCSI bus. 
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By referring to the above table, you should be able to determine the different I/O 
configurations allowed for your setup. For example, assume that you have a single-ended 
motherboard (full P2 I/O) that has a single-end^ daughter card installed. This setup 
provides two single-ended SCSI ports. Signals fi’om these ports can be routed off P3 and P4 
for front panel I/O. Or, if desired, one or both ports could be routed off P2. To determine 
the location of the connectors, refer to the figure on page 8 or 9. 

As another example, assume that you have purchased a differential motherboard (fiill P2 
I/O) that has a printer port daughter card installed. You may route signals for the 
differential SCSI port off either P3 or P2. The printer must connected to P4. 

If you plan to route SCSI signals off the P2 connector, you may wish to refer to the 
discussion on pages 20 — 21 before proceeding with the installation. 


VARIATIONS IN BOARD LAYOUT 

From an installation standpoint, there are two basic variations in the layout of the Jaguar 
motherboard. These versions differ in both the number and placement of jumpers and 
switches on the boards. 

To determine which version of the board you have, examine the 12-character artwork code 
printed on edge of the solder side of the motherboard. The artwork code has the following 
format: PB-jxcc-xcc-xcr, where is an alphanumeric character. 

— If the code is PB-0770 -j»xc-jxc or PB-0910-xcr-XOA, then your board has the layout 
shown in the figure on page 8. 

^ If the code is FB-0773-xcr-xa:, then your board has the layout shown on page 9 


The drawings on the next two pages depict the two board layouts. These layouts provide 
information that you will need in order to install your board, including the location of the 
jumper^ switch blocks, cable connectois, and daughter card (if installed). 

The figure on page 10 depicts three of the four Jaguar daughter cards —single-ended, 
differential, and Centronics/Dataproducts Short Line printer port. (The fourth daughter 
card, which prondes a printer port for Dataproducts Long Line printers, does not have any 
settings that can be changed.) 
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^ Figure 2, V/SCSI 4210 Jaguar Board Layout 

(Artwork versions PB-0770-xcc-xaf and PB-091(>-xo:-XOA) 

NOTE: On boards with PB-0910-xcr-XOA artwork, the fuse (FI) is horizontal, 
not vertical as shown above. However, it is located in the same area of 
the board. 
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Figure 3. V/SCSI 4210 Jaguar Board Layout 
(Artwork version PB-0773-xcr-xa:) 
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2 Installation 


INSTALLATION PROCEDURE 


For proper installation, it is imperative that you follow the steps below: 


Step 1. Visual Inspection 

Before attempting the installation of this board, make sure you are wearing an anti-static or 
grounding de\ice. Remove the Jaguar board from the anti-static bag, and visually inspect it 
to ensure no damage has occurred during shipment A visual inspection usually is sufficient, 
since each board is thoroughly checked ai Inierphase just prior to shipment. 

If the board is undamaged and all parts are accounted for, proceed mth the installation. 


Step 2. Set Onboard Jumpers 

Set aU onboard jumpers so that the Jaguar is properly configured for operation wi thin your 
system. The board layouts on pages 8 — 10 show the location of the jumpers. To determine 
which board layout you have, please refer to the discussion “Variations in Board Layout” 
(page 7). 


Motherboard Jumper Settings 

Terminator Power to Primary SCSI Bus . On all Jaguar board layouts, JAl is used to 
connect terminator power to the primary SCSI bus. Placing a jumper in JAl connects 
the power. The factory default setting for JAl is no jumper. 


Oscillator Test Jumpers. The jumpers used for oscillator testability differ from one 
board layotU to another. In all cases, however, they should be left in their factory 
default settings. The jumpers are as follows: 

— On the PB-0770-xar-xcc and PB-910-xa:-XOA board layout, JA2 and JA3 are 
oscillator test jumpers. Both must be left in their factory default settings 
(jumpers installed). 

— On the PB-0773-xa:-xa: board layout, JA2, JA3, JA4, and JA5 are osdllator test 
jumpers. All must be left in their factory default settings (jumpers installed in 
JA2, JA3, and JA5; no jumper in JA4). 

EPROM Size Selection . The jumper used for EPROM size also varies depending on the 
board layout In all cases, howevo*, it should be left in its foctory default setting. The 
jumper used to set EPROM size on the various motherboards is as follows: 

— On the PB-0770-xcc-xar and PB-910-xcc-XOA board layout, JA4 selects the 
EPROM size. Jumpering together 1**2 selects a 27512 64K EPROM. Jumpering 
2^3 together selects a 27256 32K EPROM. The factory default setting is 2*^3. Do 
not change this setting. 
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— On the PB-OTTS-xcc-xcc board layout, JA6 selects the EPROM size. Jumpering 
together 1**2 selects a 27512 64K EPROM. Jumpering 2'«-3 together selects a 
27256 32K EPROM. The factory default setting is 2**3. Do not change this 
setting. 


VMEbus Request Level . The Jaguar’s VMEbus request level can be set from 1 (highest) 
to 3 (lowest). 

— On the PB-0770-xcc-xa and PB-910-jxc-XOA board layouts, JA5, JA6, and JA7 
are used to set the VMEbus request level. The factory default setting is for bus 
request level 3. To change this setting to a different level, refer to the jumper 
settings depicted below. 

— On the PB-0773-xcc-xa: board layout, JA7, JA8, and JA9 are used to set the 
VMEbus request level. The factory default setting is for bus request level 3, This 
can be changed. To do so, refer to the jumper settings shown below. 

NOTE: If you are installing the Jaguar in a Sun system, the Bus Request level 

must be left in its default setting (level 3). 



Figure 5.. VMEbus Request Priority Jumper Settings 
(Motherboard) 


Early Release of VMEbus BBSY* . This feature is only provided on the PB-0773-xa:-xa: 
board layout The JAIO jumper block determines Aether the Jaguar will use standard 
or early release VMEbus arbitration when it is the bus master. If the jumper is set for 
standard release (jumper IN), the VMEbus signal BBSY* is released after the last cycle 
is completely finished. If the jumper is set for early release (jumper OUT), BBSY* is 
released at the start of the last cycle to allow for rearbitration during the last cycle. 


The -0773 is shipped with no jumper in JAIO, This factory default setting selects early 
release of BBSY*. Placing a jumper in JAIO selects standard release of BBSY*. 
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NOTE: Jaguars wth the PB-0770-jca:-xac and PB-0910-xa:-XOA board layout are 

available in versions which provide either standard or early release of BBSY*. 
(The feature is not jumper-selectable on these boards.) 


Daughter Card Jumper Settings 

If your setup includes a daughter card, it may also be necessary to set some jumpers on the 
card. To determine the location of the jumpers, refer to Figure 4. on page 10. Note that 
the Dataproducts Long Line Daughter Card does not appear in the figure, since it does not 
have any settings that can be changed. 

For clarity, the daughter card jumpers are grouped according to the type of daughter card, 
instead of the jumper function. 

Jumpers Used on Single-Ended and DifTerential SCSI Daughter Cards . On both the 
single-ended and differential daughter cards, JAl, JA2, and JA3 are used to set the SCSI 
Bus ID of Port 1. JA3 is the most significant bit of the address and JAl is the least 
significant bit. The factory default setting is SCSI Address 0. 

Placing a jumper in JAl, JA2, or JA3 selects a “1” (ON) for that bit. Leaving a jumper 
out selects a “0” (OFF) for that bit. The following table shows the possible 
combinations: 


Table 2. Setting SCSI Bus ID of Port 1 


SCSI 10 

- n 

JA3 

JA2 

JAl 

0 

OFF 

OFF 

OFF 

1 

OFF 

OFF 

ON 

2 

OFF 

ON 

OFF 

3 

OFF 

ON 

ON 

4 

ON 

OFF 

OFF 

5 

ON 

OFF 

ON 

6 

ON 

ON 

OFF 

7 

ON 

ON 

ON 


Bc^ the single-ended and differential daughter cards have a jumper (JA4) used to 
connect Port 1 to SCSI terminator power. Installing a jumper in JA4 connects the port 
to the terminator power. Both dai^ter cards are shipped with no jumper installed in 
JA4. 

The differential daughter card has an additional jumper, JA5. This jumper is used for 
testing the osdllator and should be left in its factory default setting (jumper installed). 


Jumpers Used on Centronics/Dataproducts Short Line Daunhter Card . On the printer 
port that supports Centronics and Dataproducts Short Line printers, jumpers JAl and 
JA2 are used to select the type of printer desired. The card is shipped with a jumper 
installed in JA2. This confines the card for use with a Dataproducts Short L^e 
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printer. To configure the port for use with a Centronics printer, remove the jumper 
from JA2 and install a jumper in JAl. 

Jumper Use d on Dataproducts Long line Daughter Card. The printer port that 
supports Dataproducts Long line printers has one jumper, JAl. It is us^ for testing the 
oscillator and should be left in its default setting (jumper installed). 


Step 3. Set Onboard Switches 

VariatioDS in Available Switch Options 

The Jaguar motherboard has either one or two switch blocks, depending on which version of 
the board you have. All Jaguar motherboards have a switch blo^ (SWl) that allows you to 
set the following parameters: 

— base address of the Jaguar’s 2 Kbyte short I/O RAM 

— allowed VMEbus address modifiers 
— SCSI bus ID of Port 0 

Switch block SWl is the only switch block on boards with the layout shown on page 8 
(artwork codes PB-0770-xcc-xa: and PB-910-xa:-XOA). 

Boards with -773 artwork have an additional switch block (SW2) that allows you to specify 
whether or not the Jaguar wiU: 

— reset the SCSI bus upon power-up or reset 

— remove SYSFAIL* immediately after coming out of reset 

NOTE: The SCSI reset feature is also available on Jaguars with the PB-0770-xa:-xcc and 
PB-091Oaca:-XOA board layouts. However, the parameter is not switch-selectable. 
It must be specified when ordering the board from Interphase. For a discussion 
of how these boards handle SYSFAIL*, refer to the discussion on page 28. 


Default Switch Settings 

The factory default switch settings are shown below. An “OFF’ setting equals logic 1. An 
“ON” sett^ equals logic 0. 
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Suitdi Block SU1 t 


Ftnetion 

Primary SCSI 
Bus ID 

Short I/O Address 

All A12 A13 AU A15 

Addr. 

Hod. 

Suitdi # 

1 


3 

D 

5 

6 

7 

8 

9 

Setting 

ON 


ON 

OFF 

ON 

ON 

ON 

OFF 

OFF 


Switch Block SU2 X 


Function 

Reset 

Enable 

Remove 

SYSFAIL* 






Switch # 

1 

2 

3 

4 


6 

7 

8 

Setting 

ON 

ON 

ON 

ON 

B 

ON 

ON 

ON 


f Switch block SU1 is provided on all Jaguar motherboards. 

I Switch block SU2 is provided on -0773 motherboards only. 
Switches 3 through 8 on SW2 are not used and should be left 
in their default settings. 


Figure 6.. Factory Default Switch Settings 


The default switch settings on SWl set the following parameters on the Jaguar: 

- JJ_ ^ _t_T _ n _ oort/\ /_ * _ xrk. rm- __ J j_ 

V £>ase adorer oi lac ^ fwaytc snort l/kj space is sci ai uaooou (usmj^ viviiiuus auurcss 
lines All—A15). 

• Only short supervisor accesses (0x2D) are permitted. 

• The SCSI bus ID of Port 0 is 0x0. 


The default switch settings on SW2 (provided on -0773 Jaguars only) set the following 
parameters: 

• The SCSI bus is reset after the Jaguar has been power-up or reset (Switch 1 in SW2). 

• The Jaguar removes the VMEbus SYSFAIL* signal immediately after comii^ out of 
reset (Switch 2 in SW2). 

The following sections describe how to change the default switch settings to meet the 
requirements of your specific installation. 


Setting Base Address 
of Short I/O Space RAM 


Switches 4 — 8 of SWl are used to set the base address of the 2 Kbytes of short I/O space 
RAKi on the Jaguar. As noted m the introduction, all interaction between the host and the 
Jaguar takes place in this 2K space. 


The switches corresnond to VMEbus address lines A15-A11, respectively, as shown belowc 
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Table 3. Switches Used for Short I/O Base Address 


Switch # 
SU1 — 4 
" — 5 
— 6 
H — j 

H - 8 


Address Bit 
A11 
A12 
A13 
AU 
A15 


An OFF switch has a value of *1’ and an ON switch has a value of *0’. To determine the 
ON vs. OFF setting of the switches, refer to the appropriate board layout on pages 8 - 9. 

The short I/O base addre^ must be a multiple of 0x800. The following table shows the 
switch settings for all possible base addresses. 


Table 4. Base Addresses for Short I/O RAM 


Address 

Switch Settings 

8 7 6 5 4 

0000 

0 0 0 0 0 

0800 

0 0 0 0 F 

1000 

0 0 0 F 0 

1800 

0 0 0 F F 

2000 

0 0 F 0 0 

2800 

0 0 F 0 F 

3000 

0 0 F F 0 

3800 

0 0 F F F 

4000 


4800 


5000 


5800 

0 F 0 F F 

6000 

0 F F 0 0 

6800 

0 F F 0 F 

7000 

0 F F F 0 

7800 

0 F F F F 

8000 

F 0 0 0 0 

8800 

F 0 0 0 F 


F 0 0 F 0 


F 0 0 F F 

AOOO 

F 0 F 0 0 

A800 

F 0 F 0 F 

BOOO 

F 0 F F 0 

B800 

F 0 F F F 

COOO 


C800 


0000 


0800 

F F 0 F F 

EOOO 

F F F 0 0 

E800 

F F F 0 F 

FOOO 

F F F F 0 

F800 

F F F F F 


NOTE: 0 * ON / CLOSED 
F * OFF / OPEN 
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Setting Address Modifiers Allowed in 
Short I/O Address Space 

Switch 9 in SWl is used to select the address modifiers that are permitted in the short I/O 
address space. If the switch is on, only short supervisor accesses are permitted (address 
modifier 0x2D only). If it is off, then both 0x2D and 0x29 address modifiers are allowed. 


Setting SCSI Bus ID of Port 0 

Switches 1 - 3 of SWl are used to set the SCSI Bus ID for the Jaguar’s Port 0. 

A switch in the ON or CLOSED position selects a ‘0’ for that bit. A switch in the OFF or 
OPEN position selects a ‘1’ for the bit. The following table shows the possible 
combinations: 


Table 5. Setting SCSI Bus ID of Port 0 


SCSI ID 

Suitdi Settings (SUI) 

1 2 3 

0 

ON 

ON 

ON 

1 

OFF 

ON 

ON 

2 

ON 

OFF 

ON 

3 

OFF 

OFF 

ON 

4 

ON 

ON 

OFF 

5 

OFF 

ON 

OFF 

6 

ON 

OFF 

OFF 

7 

OFF 

OFF 

OFF 


Selecting SCSI Bus Reset after Po^r-up/Reset 
(PB-0773-xa-xcr board layout only) 

When Switch 1 in SW2 is set in its default portion (ON), the Jaguar will reset the SCSI bus 
whenever the Jaguar is turned on or reset. Setting the switch to the "OFF position disables 
this feature. This option may be useful in some multi-host adapter systems. 


Selecting Removal of SYSFAIL* after Reset 
(PB-OTTS-xa-xcc board layout only) 

When Switch 2 in SW2 is set in its default position (ON), the Jaguar will remove the 
VMEbus SYSFAIL* signal immediately after coming out of reset. When it is set to "OFP, 
the Jaguar will not clear SYSFAIL* until the board has completed an extended self test and 
is rea^ to accept commands. The extended self-test takes approximately four seconds to 
execute. 
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Step 4. Set Termination 

SCSI specifications require the bus to be terminated at both ends of the SCSI cable. No other 
termination is allowed. Otherwise, a bus impedance mismatch will occur. 

The Jaguar’s primary port (Port 0) and optional secondary SCSI port (Port 1) are each provided 
with separate terminating resistors. The following statement applies to either port: If the port 
is at either end of the SCSI cable, the port’s terminating resistors should be left in place. If the 
port is not at the end of the cable, the termination should be removed. 

Note that the optional printer port daughter card has different termination requirements than 
the SCSI daughter cards. These requirements are desoribed in the subsection on daughter card 
termination, below. 

TerminatioD on Motherboard 

All versions of the Jaguar motherboard are shipped with termination installed. These resistor 
SIPs are labelled RNl, RN2, and RN3 (see the board layouts on pages 8 and 9). These resistors 
provide termination for the Port 0. If Port 0 is not at one end of the SCSI cable, remove these 
resistors from the motherboard. 


Termination on Daughter Card 

The termination on your daughter card (if you have one) depends on the card type. Refer to 
the figure on page 10 to determine the location of the terminating resistors. The different 
termination sdiemes are summarized below: 

• Single^ended daughter ^ird: P.e-sistois RNl, RN2, and RN3 on the daughter card (not the 
motherboard) provide termination for the secondary SCSI bus (Port 1). If the Jaguar is not 
at one end of the SCSI cable, these resistor SEPs should be removed. 

• Differential daughter card: Resistors RN3, RN4, and RN5 on the daughter card provide 
termination for Port 1. If Port 1 is not at one end of the SCSI cable, these resistor SIPs 
should be removed. 

• Dataproducts Long line printer port The terminators are set correctly for a Dataproducts 
Long Line printer and should not be changed. 

• Dataproducts Short line/Centronics printer port 

For use with Dataproducts Short Line printer 

- RN2 and RN3 should both be 3§0n 

For use with Centronics printer 

- RN3 should be 47Dn 

RN2 is not used (if RN2 is installed on the card, remove it) 

NOTE: The Dataproducts Short Line/Centronics printer port is shipped with 3900 
resist(KS installed in RN2 and RN3. 
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Step 5. Power Off System 


Once the board is configured, ensure that the host system and peripherals are turned OFF. 


CAUTION 

System power and periphenU power must be turned OFF before attempting to install the 
Jaguar. Failure to do so may result in severe damage to the board atxd/or system. 
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3 

JAGUAR SYSTEM INTERFACE 


OVERVIEW 


The host communicates with the Jaguar through 2048 bytes of short I/O space located on 
the Jaguar. This memory is mapped into the short I/O space of the VMEbus. Every 
location can be both written to and read from, physically, by the host at any time, but the 
protocol of the Jaguar MACSI System Interface puts some restrictions upon when certain 
areas should be accessed. Also, some areas are logically write only or read only. MACSI 
partitions this RAM into six major sections: 

• Master Control/Status Block (MCSB) 

• Master Command Entry (MCE) 

• Command Queue (CQ) 

• Host Usable Space (HUS) 

• Command Response Block (CRB) 

• Controller Specific Space (CSS) 

The Master Control/Status Block is used to pass and receive information relative to the 
overall operation of the Jaguar. The Mailer Control/Status Block is 16 bytes long. 

The Master Command Entry is used to issue commands to the Jaguar before the Command 
Queue and work queues have been initialized. Typically, it will be used only when initializing 
the Command Queue and work queues. It does, however, provide a mechanism to issue a 
command to the Jaguar even if the Command Queue and aU work queues are full. The 
single slot of the MCE has the same 12-bytc format as any other Command Queue entry. 
Space must be reserved in the Host Usable Space (HUS) portion of the short I/O space for 
the lOPB that is pointed to by the MCE. 

The Command Queue consists of a user>programed number of Command Queue entries. 
Each Command Queue entry includes all of the information that is needed for the host to 
find, execute, and respond to the commands contained in an lOPB. The Command Queue is 
circular, and it is up to the host to keep track of the next Command Queue entry that it can 
use. Because the queue is circular, the Jaguar infers chronolo^cal ordering of commands. 
Each Command Queue entry is ”bu^ onfy until the Jaguar can transfer the command to a 
work queue and then free its slot in the Command Queue. The number of entries in the 
Command Queue is programmed via the Initialize Controller command. The actual size of 
the Command Queue equals the number of entries times 12 bytes. 

The Host Usable Space is fiee-form memory space accessible to both the host and the 
controller. It is typically used for lOPBs. However, for multiprocessing applications, this is a 
convenient place for semaphores between CPUs. The amouiU of HUS available is 
determined by the number of Command Queue entries defined when the Command Queue 
is initialized and by the length of the Command Response Block. For example, if the 
Command Queue is initialized with 10 entries and the Command Response Block of 76 
bytes is defined, there will be 1704 bytes of HUS available. Tne Master Controi/Status 
Block, Master Command Entry, and the Controller Specific Space always occupy a total of 
148 bytes. 
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The Command Response Block is used by the Jaguar to post command completion status. 
The lOPB itself and related status information are returned to the Command Response 
Block. In addition, if enabled to do so, the Jaguar uses the CRB to signal that space has 
become available in the Command Queue to accept new entries. The offset of the 
Command Response Block is defined during initialization. 

The Controller Specific Space is a l^byte space used by the Jaguar to post the 
Configuration Status Block. The Jaguar uses the Configuration Status Block to report the 
firmware revision level, information on product number and variations, available buffer 
space and the SCSI bus IDs that it is using. 


offset from 
Short I/O 


Base Address 


+0x0 j 

to 
+0xF 

Master Control/Status Block 

+0x10 

to 

+0x1 B 

Master Conmand Entry 

+0x1 C 
to 

+0x93 

Command Queue 

+0x94 

to 

+0x73B 1 

Host Usable Space 

O 

X O X 

Conmand Response Block 

+0x788 

to 

+0x7FF 

1 Configuration Status Block 


NOTE: The above memory map is for a Jaguar that has been 

initialized uith a 10-entry Connand Queue and a maxinuii 
lOPB length of 64 bytes. 


Figure 8. Typical Memory Map of Jaguar Short I/O Space 


MASTER CONTROL/STATUS BLOCK (MCSB) 

The Master Control/Status Block (MCSB) consists of the Master Status Renter (MSR), 
the Master Control Register (MCR), the Interrupt on Queue Available Register (IQAR), 
and the Queue Head Pointer (QHP). 
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word # 


0x0 

0x1 

0x2 

0x3 

0x4 

0x5 

to 

0x7 


MASTER STATUS REGISTER 
MASTER CONTROL REGISTER 
INTERRUPT ON QUEUE AVAILABLE REGISTER 
QUEUE HEAD POINTER 
THAU UORK QUEUE REGISTER 


RESERVED 


Figure 9. Master Control/Status Block (MCSB) 


Master Status Register (MSR) 

The Jaguar uses this register to report board level status. From the host point of reference, 
this is a READ ONLY register. However, the contents of this register are not valid for 100 
microseconds following a controller reset. The bits are defined as follov^: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RSRV jQFC{BOK|CNA j 

Figure 10. Master Status Register (MSR) 


Bit 0 Controller Not Available (CNA): 

The Jaguar sets this bit to *T to indicate that it is Not Available to receive a command. 
This condition can be caused either by a controller reset or by the execution of controller 
diagnostics. CNA wU also be set if a board initialization command fails to complete (see 
Initialize Controller Command). The Jaguar will clear this bit when it is capable of 
accepting a command. 

Bit 1 Board O.K. (BOK): 

The Jaguar sets this bit to ‘T when the power-up diagnostics are completed successfully. 
A ^ indicates that the Jaguar detected a failure during the power-up diagnostics or 
during a board initialize command. The BOK bit is not valid for 100 microseconds after 
a controller reset 
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Table 6. Board OK/Controller Not Available Relationship 


m 

□ 

DESCSIPTIOM 

0 

0 

The controller has failed to operate and is not 
capable of accepting a cosmand. 

0 

1 

Controller is Not Available. If the controller is 
not still executing power-up diagnostics, then it 
has either failed to execute power-up diagnostics 
correctly or it has failed to complete a board 
initialize coontand. 

1 

1 

The controller has successfully completed power-up 
diagnostics but it is not capable of accepting a 
command, because it is executing the diagnostics 
coomand. 

1 

8 

The controller has completed diagnostics and is 
capable of receiving commands. 


Bit 2 Queue Flush Complete (QFQ: 

The QFC bit is set to 1 by the Jaguar after it performs a flush queue operation. It is 
cleared by the Jaguar after the Flush Queue bit in the Master Command Register is 
cleared by the host (see MCR bit descriptions under Master Control Register for more 
detail). 

Bits 3-15 Reserved (RSRV): 

These bits are reserved and are cleared to 0 by the Jaguar. 

Master Control Register (MCR) 

All bits in this register are both set and reset by the host. From the Jaguar's point of 
reference, this is a READ ONLY register. The Jaguar will never set any of these bits. The 
bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RSRV jSFENlRESjFLQi RSRV |FLQRjRSRV|SQM| 


Figure 11. Master Coi^ol Re^er (MCR) 


Bit 0 Start Queue Mode (SQM): 

Until the Command Queue and work queues are initialized, all commands to the Jaguar 
must be issued to Work Queue 0 throu^ the Master Command Entry. Once the 
Command Queue and work queues have been initialized, the host starts Queued lOPB 
operation by setting this bit to *r. The host sets this bit only after it has initialized both 
the Command Queue and the work queues. This bit is set only once by the host and is 
never reset during normal operation. The Jaguar will acknowledge entering Queued 
lOPB mode by settii^ the Queue Mode Started bit in the Command Response Status 
Word to ‘1’ (see Command Response Status Word). No interrupt will be generated. 

Bit 1 Reserved (RSRV): 

This bit is reserved and must be cleared to 0 by the host. 
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Bit 2 Flush Qorae and Report (FLQR): 

The Flush Queue and Rep(^ bit causes the Jaguar to dear all In Progress commands 
and all queued commands from both the Command Queue and the work queues. Any In 
Prt^ess (currently executing) ocunmand will execute normally. 

As each command is cleared, a Command Complete Interrupt (with error completion 
status) is generated. At the completicm oi the entire Flush Queue and Report operation, 
a final Command Complete Interrupt is generated. This final Command Complete 
Interrupt uses the Controller Interrupt Vector. When this interrupt is generated, the 
Queue Flush Complete bh (QFC) wM be set in the Master Status Re^er. The host 
should clear the Flush Queue and Report befcnu clearing this la^ interrupt. The host 
must wait for this final Flush Queue and Repwt Ctunmand Complete Interrupt before 
entering any new commands, because the Jaguar will continue flushing commands until 
there are no further commands to flush. Thus, any command entered before the Flush 
Queue and Reptut Command Complete Interrupt will be flushed. 

NOTE: The ho^ may reset the SCSI bus by issuk^ a Reset SCSI Bus lOPB. 

Individual work queues are cleared using the Flush Work Queue command. 

Bits 3>10 Reserved (RSRV): 

These luts are reserved and must be cleared to 0 by the host. 

Bit 11 Flush Queue (FLQ): 

Flush Queue operates the same as Flush Queue and Report except that there is no 
report (Command Complete Interrupt) as each command is flushed. A Flush Queue 
generates only one Command Complete Interrupt at the completion of the entire 
operation. The Controller Interrupt Vector Register is used for the Command Complete 
Interrupt The host must wait for the Flush Queue Command Complete Interrupt before 
entering new commands, because the Jaguar will continue flushing commands until there 
are no furth» ccunmands. 

Bit 12 React CmitroUa’ (RES): 

The Reset Omtroller bit contrds Um microprocessor hardware reset line. It also causes 
a RESET on both the SCSI buses, if the SCSI reset feature is enabled (see the 
discussion of SW2 on p. 14). 

Obviously, the Reset Controller bit should be used only to recover from extreme error 
conditions. To ensure proper operatiiHi, the host must leave this bit for at least 50 
microseconds. 


Bit 13 SYSFA1L« Enable (SFEN): 

The SYSFAIL* Enable bit enables the Jagu^ to drive the SYSFAIL* signal on the 
VMEbus if it detects an inrer nal failure during power-up diagnostics or if the firmware 
enters an unused exceptKHi vector. If this is *0*, the Jaguar will not drive the 
SYSFAIL* si gnal under any circumstances. The Jaguar initializes this bit to ’0* after 
power-up. 

The Jaguar does not read the SYSFAIL* EnaUe bit until detecting an error in the 
power-up test After detecting an errw the firmware simply loops on setting the 
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SYSFAIL* line to the level specified by the bit (provided that the Jaguar is sufficiently 
functional to have the bit cleared). 

The host may turn off SYSFAIL* frcnn the Jaguar by cfearing this bit The ho^ may 
emd>le SYSFAIL* aftm* the Jaguar has been released from reset. This operation is 
perfcnmed by firmware, and it is possiUe the Jaguar may dear the bit if it is set too soon 
after power-up. The host should therefore wait 20 seconds after resetting the Jaguar 
before enabli^ this bit 

NOTE: A Jaguar with the board laycnit shown on page 9 always drives SYSFAIL* at 
system reset It also immediately dears SYSFAIL* alter reset if it has been 
enaUed to do so (le. Switch 2 on Switch Block SW2 is in the ON position). 

The other version ol the board (p. 8) does not have the configuration svvitch. 

It randomly either drives SYSFAIL* at reset or doesn’t and then dears 
SYSFAIL* immediately alter reset 


Bits 14-15 Reserved (RSRV): 

These bits are reserved and must be deared to 0 by the host 

Interrupt on Queue Available Register (IQAR) 

As discussed pre^ously, each Command Queue entry only occupies a slot in the Command 
Queue umil it is moved into a work queue. Thus, the host will virtually ahrays have slots 
available in the Command Queue for issuing commands. In the unlikefy event that the 
Command Queue is fiill when the ho^ attemj^ to enter a command, the host must wait 
nnHI the Jaguar tranters a c^unand firemi the Command Queue to an internal work queue 
bef(ve it can enter the next command. 

The host determines that the Command Queue is full by looking at the Go/Busy bit in the 
next available Command Queue Emry. The Command Queue is full if the Go/Busy bk of 
the next available Command Queue entry is *1*. If the Command Queue becomes fiiU, the 
host could simply poll the Go bit, waiting until the next Command Queue entry becomes 
available. But the Jaguar, through the Interrupt (» Queue Available Reg^er, provides for 
effident operation by optionally interrupting tiie host when a entry becomes available in the 
Command Queue. Thus, even in the unlikefy case that the Command Queue is full when the 
host tries to enter a command, the host need not be concerned with any intimate timing 
issues of the Jaguar’s Ctmimand Qi^ue. 

The Interrupt oa Queue Available is enaUed by setting the Interrupt on Command Queue 
Available Int in the Interrupt on Queue Availabte Raster (IQAR). If the Interrupt on 
Queue Half Empty EnaUe 1^ is also s^ the Jaguar will not interrupt until the Command 
Queue is half empty. Otherwise, the interrupt will occur as soon as ^ Jaguar detects one 
empty entry in the Command Queue. TIm host should wait until encountering the Queue 
Full condition before setting the IQEA bit Once the IQEA Int is set the Jaguar generates 
an interrupt as soon as the necessary queue conditions are satisfied. Once the interrupt is 
generated, the Jaguar resets the IQEA 

The level and vector fcx’ the IQEA iiUerrupt are supplied by the host in the IQAR. When 
the necessary queue conditimis are satisfied the Jaguar clears the IQEA and generates a 
Command Complete Interrupt with tlm Queue Enb^ Available (CQA) set in the 
Command Res^xmse Status Word (CRSW) of the Omimand Response Bkck (CRB) (see 
Command Response Status Word). Even thou^ the Jaguar (vovides f(x efficient operation 
by providing thk medianism for interrupting the host space becomes available in the 
Command Queue, it is preferable to up a large enou^ Command Queue so that the full 


28 



3 System Interface 


condition occurs infrequently. The number of entries in the Command Queue is set in the 
Controller Initialization Blo^ (see Initialize Controller Command). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

ilQEAllQHEj RSRV j IL | IV j 


Figure 12. Interrupt on Queue Available Register (IQAR) 


Bits 0-7 lutciTupt y^Aor for the Interrupt on Queue Available (IV)t 

The Jaguar uses this byte as the interrupt vector i^hen issuing an Interrupt on Queue 
Available interru{^. byte is s^ by the host and is not modified by the Jaguar. The 
host must n<^ modify this byte after setting the IQEA bit. 

Bits 8-10 Interrupt Level for the Intorupt on Queue Available (IL): 

These three bits determine the interrupt level that the Jaguar will use when issuing an 
Interrupt on Queue Available interrupt. These bits are set by the host and are not 
modifi^ by the Jaguar. After setting the Interrupt on Queue Entry Available bit. Bit 15, 
the host must not modify these bits. 

Values of ‘0’ through‘T are allowed. An interrupt level of *0* is allowed only when the 
IQEA bit is reset. 

Bits 11-13 Reserved (RSRV): 

These bits must be cleared to 0 by the host. 

Bit 14 Interrupt on (^ueue Half Empty Enable (IQHE): 

This bit is a flag which causes the Jaguar to generate the Interrupt on Queue Available 
interrupt when the Command Queue becomes half empty (rather than as soon as one 
entry b^mes available). The Interrupt on Queue Half Empty Enable (IQHE) bit is 
valid onfy v^en the IQ^ bit is set The IQHE bit is set by t^ host and is not modified 
by the Jaguar. The host must not modify this bit after it has set the IQEA bit 

Bit 15 Interrupt <mi Queue Entry Available (IQEIA): 

This bit is set by the host to request an Interrupt on Queue Entry Available. The 
interrupt is generated either when tl:« queue is half empty or as soon as one entry is 
available, depending upon the state of the IQHE bit T^ Jaguar resets this bit prior to 
generating the Intemi^ on Queue Available interrupt After the host sets this bit, 
requesting an interrupt, it cannot change any of the other bits in the Interrupt on Queue 
Available Register. 

Queue Head Pointer 

The Co mman d Queue is a circular queue and the Jaguar requires that the host use the 
entries in the Command Queue in order. The Queue Head Pointer provides a convenient 
method for the ho^ to centred the ordering of and the access to ti^ Command Queue. The 
Queue Head Pointer register provides a place for the host to stcure the address of the next 
available entry in the Command Queue. 
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15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

Queue Head Pointer (Address) 


Figure 13. Queue Head Pointer/Queue Head Pointer In Use 


Bits 0-15 Queue Head Pointer (Address): 

This is the address of the next entry in the Command Queue. Since the Jaguar transfers 
commands out of the Command Queue in circular order as soon as it sees the Go/Busy 
bit set, this address is not actually used by the Jaguar. 

The MACSI interface of the Jaguar relies on the chronological order of the Command 
Queue. The host must somehow ensure that the entries in the dlommand Queue are 
used in chronological order. 

Thaw Work Queue Register 

This field is used to restart a work queue that has been frozen after an error has occurred 
with Freeze Work Queue on Error enabled. A queue is thawed by writing the appropriate 
work queue number to the upper byte of the register and then setting Bit 0 (THW). See 
“Error Recovery Tools’* in Chapter 6 for additional information. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


} # OF WORK QUEUE TO BE THAWED { RESERVED | THW \ 


Figure 14. Thaw Work Queue Register 


Bit 0 Thaw Work Queue (THW): 

Setting this bit causes the Jaguar to: 1) resume execution of commands in the work 
queue specified in Bits 8-15, and 2) clear the entire Thaw Work Queue Register to 
ackno^edge that the queue has b^n thawed. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

Bits 8-15 Nombar of Work Queue to be Thawed: 

This field specifies the work queue to be unfrozen. Valid entries in the field are 0x1 - 
OxF (for Work Queues 1 -14, respectively). This value must not change while Bit 0, 
THW, is set to L 


MASTER COMMAND ENTRY (MCE) 

Ti^ Master Command Entry (MCE) is used to issue commands to the Jaguar before the 
Command Queue and work queues have been inkialized. Until the Jaguar has been 
commanded to enter Queue Mode, all commands must be entered through the MCE. 
Typically, it will be used only when initializing the (Command Queue. 
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It does, however, provide a mechanism to issue a command to the Jaguar even if the 
Command Queue and all work queues are fulL It provides a way to get one command into 
the Jaguar even when the Command Queue is "locked up." 

The Master Command Entry has the same 12-byte format as a Command Queue entry for 
on-board lOPBs. Its fields also have the same definition. The format is as follows; 


vMrd # 


0x0 

0x1 

0x2 

0x3 

0x4 

0x5 


QUEUE ENTRY CONTROL REGISTER 
lOPS ADDRESS 


COMMAND TAG 


lOPB LENGTH | WORK QUEUE NUMBER 

RESERVED 


Figure 15. Master Command Entry 

Before you issue a command to the Master Command Entry, the lOPB pointed to by the 
MCE must already be written to the Ho^ Usable Space (HUS) portion of short I/O space. 


COMMAND QUEUE 

The Command Queue (CQ) consists of a user-programmed number of Com m and Queue 
entries. The entries in the Command Queue is set by the host when it initializes the 
controller. The Command Queue is circular, but it is up to the host to keep track of the 
next Command Queue entry that it can use. Because the queue is circular, the Jaguar can 
infer chronological ordering of commands. The actual size of the Command Queue equals 
the number of entries times 12 bytes. The Command Queue must have at least one entry. 

Command Queue Entry (CQE) 

A Command Queue entry is a 12-t^e block containiog all of the information needed for the 
host to find and execute a command. Each entry in the Command Queue is "busy” only until 
the Jaguar can transfer the command to a work queue and then free the entry by clearing 
the Go/Busy bit This mechanism allows a relatively small Command Queue to handle a 
large numb^ of commands. 

The purpose of the fields in a Command Queue entry will vary depending on whether you 
are implementing onboard or oSboard lOPBs. The format of the two types of Command 
Queue entries are shown below: 
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word # 
0x0 
0x1 
0x2 
0x3 
0x4 
0x5 



COHHAND QUEUE ENTRY FOR 

ONBOARD lOPBs: 


* 





QUEUE ENTRY CONTROL 

REGISTER 


lOPB ADDRESS 

... 

CQHHAND TAG 


... 


lOPB LENGTH { 

WORK QUEUE NUMBER 


RESERVED 


COHMAWD QUEUE ENTRY FOR OFFBOARD lOPBs : 

uord # 

0x0 
0x1 
0x2 
0x3 
0x4 
0x5 


Figure 16. Command Queue Entry Format for Onboard and Offboard lOPBs 

CQE Word 0.- 

Queue Entiy Control Register 

The Queue Entry Control Register (QECR) is used to: 1) kick off command execution, 2) 
acknowledge a command abort sequence, 3) flag a high priority command, and 4) signal 
whether a command is located in short I/O (onboard lOPB) or in system memory (offboard 
lOPB). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RSRV I lOPB TYPE { RSRV jFOB iRSRVjHPCj AAiOOj 


Figure 17. Queue Entry Control Register (QECR) 



QUEUE 

ENTRY CONTROL 

REGISTER 


RSRV 1 

TT 1 

MT j 

ADDRESS MODIFIER 


(MSW) 

(LSW) 


HOST ADDRESS 


... 

lOPB 

LENGTH 

1 

WORK QUEUE NUMBER 


RESERVED 


Bit 0 Go/Busy (GO): 

The Go/Busy bit is set by the host to initiate action on a Command Queue entry. The 
host must assemble the lOPB in the Host Usable Space (HUS) and assemble the entire 
Command Queue entry in the Command Queue before it sets this bit. The Jaguar moves 
the Command Queue entry and the lOPB into internal memory as soon as it sees the 
Go/Busy bit set. Once the lOPB and Command Queue entry are in internal memory, 
the Jaguar will reset the Go/Busy bit to free the Command Queue entry. 


32 
















3 System Interface 


Bit 1 Abort Acknowledge (AA): 

When a command completes vwth error, all commands in that work queue can optionally 
be aborted. In addition, all commands in the Command Queue that are destined for tha t 
work queue are also aborted. This option is specified when the work queue is initialized 
(see Abort Enable bit in the Initialize Work Queue command). 

The Abort Acknowledge bit is used to stop aborting commands after this condition 
occurs. When a command completes with error, a typical response is for the host to re¬ 
issue the command that completed in error, with the Abort Acknowledge bit set. Upon 
successful completion of the command, the host can then re-issue each command that 
was aborted b^use of the error. These subsequent commands should not have the 
Abort Acknowledge bit set. 

Bit 2 High Priority Command (HPC): 

The High Priority Command (HPC) bit flags a command so that the Jaguar places the 
command at the top of its work queue. If there are already other commands in the work 
queue with the HPC bit set, the new command is queued up directly behind the other 
High Priority Commands. (Thus, there is a FDFO-type ordering of High Priority 
Commands.) 

Bit 3 Reserved (RSRV): 

This bit is reserved and must be cleared to 0 by the host. 

Bit 4 Fetch Offboard (FOB): 

This bit is only used in applications involving offboard lOPBs. If this bit is set, then the 
offboard Command Queue entry and its corresponding lOPB will be fetched from the 
host memory. The only other bit in the Queue Entry Control Register that is valid when 
the FOB bit is set is the Go/Busy bit (Bit 0). For a discussion of offboard lOPBs, refer 
to the section “Offboard lOPBs” in Chapter 6. 

Bits 5*7 (RSRV) Reserved: 

These bits are reserved and must be cleared to 0 by the host 
Bits 8-11 lOPB Type: 

These bits describe the lOPB type. The Jaguar supports only type zero lOPBs. 

Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 


CQE Word 1; 


For onboard lOPBs, Command Queue Entry Word 1 is used to store the lOPB Address. 
For offboard lOPBs, it holds the memory t)^, transfer type, and address modifier used by 
the Jaguar to DMA the offboard lOPB into onboard mem(^. These two uses of the field 
are explained below. 

lOPB Address. For an onboard lOPB, Command Queue Entry Word 1 points to the 
location of the lOPB in short I/O. The value is specified as an offset from the short I/O 
base address. The Jaguar transfers both the Command Queue entry and the lOPB out of 
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short I/O as soon as it “sees” that the Go/Busy bit is set. 

Memory Type/Transfer Tyne/Address Modifier. For an offboard lOPB, Command Queue 
Entry Word 1 is used to specify the memory type, transfer type, and address modifier used 
to transfer the lOPB onboard. This field is identical in format and purpose to the Memory 
Typc^ransfer Type/Address Modifier field in word 7 of the Printer Port lOPB. For a 
description of the field, see page 60. 

CQE Words 2-3: 

For onboard lOPBs, Command Queue Entry Word 2 is used to store a host-assigned 
command tag. For offboard lOPBs, it holds the physical address of the offboard Command 
Queue entry/IOPB. These two uses of the field are explained below. 

r.nnimand Tay. For onboard lOPBs, Command Queue Entry Words 2-3 can be used to 
store a host-specified command tag. The Jaguar does not use or modify the value stored in 
this field. It simply returns the Command Tag as part of the Command Response. Thus, in a 
typical implementation, the host would use a unique value Command Tag for each 
^mmand Queue entry so that it can always differentiate one command from another. 

Host Address. For offboard lOPBs, Command Queue Entry Words 2-3 are used to store 
the physical address of the offboard Command Queue entry and its corresponding lOPB in 
host memory. Word 2 stores the most significant word (MSW) of the address, and Word 3 
stores the LSW. 


CQE Word 4: 


CQE Word 4 consists of a Work Queue Number field and an lOPB Length field. 


15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

lOPB LENGTH ) WORK QUEUE NUMBER 


Figure 18. lOPB Length/Work Queue Number 
Bits 0-7 Work Queue Numben 

This byte contains the number of the work queue into ^ch the command is to be 
placed. Since the Jaguar supports 15 work queues (14 device-specific queues plus Work 
Queue 0), valid entries in th^ field are QxO to QxE. 

NOTE: Befcve you can issue a command to Work Queues 1 -14, that work queue 

must be inidalized using the Initialize Work Queue command. If the specified 
work queue has not been initialized, the command will be reported as 
completing an error (return status = 0x07, Queue Uninitialized). 

Bits 8-15 lOPB Length: 

The lOPB Length byte spedfies the length of the lOPB to which the Command Queue 
entry is pointing 

For onboard lOPBs, writing a X)* to this field indicates that the default length of the lOPB 
is being used. This field should only contain a non-zero value if the lOPB involves a 
vendor-unique SCSI command (Group 6 or 7). Refer to the SCSI Pass-Through lOPB 
section (p. 48) for additional inform^Oion. 

For offboard lOFBs, the Jaguar will add the value in the lOPB Length to 12 (the number of 
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bytes in the CQE). This value determines how many bytes it will DMA into its memory, 
llierefore, the field should contain the exact number of bytes in the lOPB. 


CQE Word 5: 


CQE Word 5 is reserved for both onboard and ofiboard lOPBs. This field should be 
cleared to 0 by the host. 


HOST USABLE SPACE (HUS) 

The Host Usable Space (KUS) is freeform memory space accessible to both the host and 
the controller. No partitioning of the HUS is impli^ or required by the Jaguar MACSI 
interface. The manner in which it is used is totally under the control of the host. Typically, 
the HUS in the Jaguar is used to pass the lOPB portion of a command. In some 
multiprocessing applications, the HUS is a handy place to post semaphores between CPUs. 

The amoimt of HUS available is determined two factors: the number of Command 
Queue entries defined when the Command Queue is initialized, and by the length of the 
Command Response Block that is defined. For example, if the Command Queue is 
initialized with ten entries (each Command Queue entry is 12 bytes long) and a Command 
Response Block of 76 bytes is defined, there will be 1704 bytes of HUS available. The 
Master Control/Status Block, Master Command Entry, and the Controller Specific Space 
always occupy a total of 148 bytes. 

COMMAND RESPONSE BLOCK (CRB) 

The Command Response Block (CRB) is used by the Jaguar to post command completion 
status. The lOPB itself and relat^ status information are returned to the Command 
Response Block. 

The CRB is also used to return an error status block in the event of a controller interrupt 
(see Bit 7, Status Change, in the Command Response Status Word of the CRB). 

In addition, if enabled to do so, the Jaguar uses the CRB to si^ial that space has become 
available in the Command Queue to accept new entries. (The latter use of the CRB only 
occurs after a “queue full” condition. See “Interrupt on Queue Available Register”, page 
28, for details.) 

The CRB is made up of the Command Response Status Word (CRSW), the Command Tag, 
the Work Queue Number, and the Returned lOPB. 

The offset of the Command Response Block is defined at initialize time. The length of the 
Command Response Block can be determined by subtracting the Command Response Block 
o&et from the offset of the Controller Specific Space (+0x788). However, the length of the 
Command Response Block must be equal to the largest lOPB defined plus 12 bytes. A 
recommended value for the Command Response Block length is 76 bytes. 
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Offset 

froi Short I/O 

(Offsets assume a maxiimja lOPB length of 32 bytes) 


The above is the memory map of the Command Response 
Slock if the maxinua lOPB length is that of a 
SCSI Pass-Through lOPB used to issue a 12-byte SCSI 
conmand (i.e. max. lOPB length « 32 bytes). 


Figure 19. Command Response Block (Sample Memory Map) 


Command Response Status Word (CRSW) 

The Command Response Status Word (CRSW) is the first word in the Command Response 
Block (CRB). It desoibes the nature of the Command Response. It also contains a 
Handshake bit and the Command Response Block Valid/Clear Interrupt (CRBV) bit. (The 
CRBV bit synchronizes the command interaction of the Jaguar and the h(»t.) The bits of 
the Commaiid Response Status W^crd are defined as fcllcwsi 

15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


RSRV jsc !cqa|qms{ aq jEX {er |cc|crbv| 


COMMAND RESPONSE STATUS WORD 
RESERVED 


COMMAND TAC 


lOPB LENGTH j UORk QUEUE NUMBER 

RESERVED 


RETURNED lOPB 


Ba&e Address 

+0x73C 

+0x73E 

+0x740 

+0x742 

+0x744 

+0x746 

+0x748 

to 

+0x773 

NOTE: 


Figiure 20. Command Response Status Word (CRSW) 


Bit 0 Conunand Response Block Valid/Clear Interrupt (CRBV): 

The Command Response Block Valid/Qear Interrupt (CRBV) bit is set by the Jaguar 
after it loads the returned lOPB, the W(»k Queue Number, and the Command Tag into 
the Command Response Block (CRB). 

The CRBV bit is also an Interrupt Pending bit because the Jaguar sets it immediately 
prior to issuing a Command Complete interrupt to the host The Jaguar keeps the 
Command Response Block stable vviiile this bit is set 

After it is finished using the information in the Command Response Block, the host 
clears the interrupt by clearing the CRBV bit Once this bit is reset, the Jaguar can use 
the Command Response Block to present the next command response. 
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Bit 1 Command Complete (CQ: 

The Command Complete (CC) bit is set by the Jaguar when the Command Response 
Block is being used to post the response to a Command Completion, as opposed to a 
Queue Entry Available condition or a Start Queued Mode operation. The CC bit is set 
even when the command is completed with error or exception. (See Command Response 
Status Word (CRSW) bits 2 and 3.) 

Bit 2 Error (ER): 

The Error (ER) bit is set by the Jaguar when the Command Response Block contains an 
lOPB that has completed with an error status. Examples of conditions that may cause 
an lOPB to complete with the Error bit set include: 

— an incorrectly spedfied param^er 'widch causes the Jaguar to misinterpret the 
command 

— an invalid address leading to bus errors or timeouts 

— a faulty device which causes a timeout 

The Error bit will also be set for Pass-Through commands that return any value other 
than zero in the Pass-Through Status or Controller Status fields. 

The Error bit is valid only when Command Complete is active. 

Bit 3 Exception (EX): 

The Exception (EX) bit is set by the Jaguar when the Command Response Block 
contains an lOPB that has completed with an exception. 

A command completed with exception is one which completed without error, but has 
some lOPB parameter that has nc^ been completely satisfied. EXAMPLE: The Jaguar 
completes a Pass-Through SCSI command without transferring all of the data specked 
in the IOPB*s transfer count field. (For many SCSI commands, this is not an error 
condition, but rather something about which the host probably needs to be notified.) 

The Esrei^on bit is valid only when Command Complete is active. 

Bit 4 Abort QiMue (AQ): 

When work queues are initialized by the host, they can be set up (optionally) so that all 
of the commands in the queue can be aborted after a command completes with an error. 
(See TnitialiTc Work Queue Command.) The command that was completed with an error 
is reported just like any other error, with the Error bit set in the Command Response 
Status Word 

>^th Abort on Error enabled, the Jaguar, on an error, will abort all commands m the 
work queue. In addition, all commands in the Command Queue destined for that work 
queue will be aborted until a command with the Abort Acknowledge bit set in the Queue 
Entry Control Register is encountered. (Sec Queue Entry Control Register). All of the 
aborted commands are reported in the Command Response Block with the Command 
Complete, Error, and Abort Queue bits set The Error Interrupt Vector of the command 
being aborted will be used to report this condition. 

Bit 5 Queue Mode Started (QMS): 

The Queue Mode Started (QMS) bit is set by the Jaguar in response to the host setting 
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the Start Queue Mode (SQM) bit in the Master Control Register. (See Master Control 
Register). 

Once the Command Queues and work queues have been initialized, the host starts 
Queued lOPB operation by setting the SQM bit in the Master Control Register, The 
Jaguar acknowledge entering Queued lOPB mode by setting the Queue Mode 
Started bit in the Command Response Status Word. No interrupt will be generated. 

Bit 6 Command Queue Entry Available (CQA): 

The Command Queue Entry Available (CQA) bit is set by the Jaguar when the 
Command Response Block is presented in response to a queue entry available condition. 
The CQA bit is mutually exclusive wth the Command Complete bit. 

Bit 7 Status Change (SC): 

This bit is set to indicate one of the following conditions: 

— A printer status change has occurred. 

— A device has connected for which no lOPB exists (lOPB type error). 

— An lOPB has timed out. 

— A device is requesting more data to be transferred than the lOPB allows. 

— A device is requesting a data transfer of the opposite direction specified by the 
lOPB’s direction bit. 

If Bit 7 is set, the Jaguar will return an error status block without returning the lOPB 
that caused the error. Refer to “Controller Error Interrupt and Vector”, p. 128, for 
details on this special case. 

Bits 8>15 Reserved (RSRV): 

These bits are reserved and are cleared to 0 by the Jaguar. 


Command Tag 

This Command Tag is the same 4-byte value that was provided in the Command Queue 
Entry when this command was ori^nally issued to the Jaguar. The J^;uar do^ not use the 
Command Tag, nor does it modify it It ^ply returns the Command Tag as part of the 
Command Response. The Command Tag is u^ by the host to determine to which 
command the Jaguar is responding. 


lOPB Length/Work Queue Number 

The lower byte of this word specifies the number of the work queue to which the command 
was issued. The upper byte specific the lengdi of the returned lOPB. A length of zero 
indicates the lOPB is the default length. The entire lOPB Length/Work Queue Number 
word is returned fiom the Command Queue entry exactly as it was originally entered by the 
host 

Returned lOPB 

The Returned lOPB field of the Command Response Block is usually an image of the lOPB 
that was passed with the Command Queue EiUry when the command was originaiiy issued 
to the Jaguar. In some cases, depending upon the specific lOPB, some of the parameters 
are modified to reflect Command Completion status. 
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This returned lOPB area is undefined for a response to a Queue Entry Available condition 
or for any other command response where the original command did not require an lOPB. 


CONTROLLER SPECIFIC SPACE 

The Jaguar uses the 120-byte Controller Specific Space to post the Configuration Status 
Block. This space begins at an offset of +0x788 fi-om the short I/O base address. 

Configuration Status Block 

The Jaguar uses the Configuration Status Block to report its current configuration. This 
includes such information as the board’s firmware revision level, product number and 
variations, available buffer spa<^, and the SCSI bus IDs that it is using. The format of the 
Configuration Status Block is shown below: 
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OFFSET 

+0x788 

+0x78A 

+0x78C 

+0x78E 

+0x790 

+0x792 

+0x794 

+0x796 

+0x798 

+0x79A 

to 

+0x7Al 

+0x7A2 

+0x7A4 

+0x7A6 

+0x7A8 

+0x7AA 

+0x7AC 

+0x7AE 

+0x7B0 

+0x7B2 

'^0x734 ■ 

+0x7B6 

+0x7B8 

+0x7BA 


The following is a description of the values found in the Configuration Status Block. 
Product Code (3 bytes): 

These three bytes are the Interphase product code. This value is represented as a 3< 
character ASCII strii^ The most sigr^cant character appears first It is valid after the 
completion of a controller reset 

Product Variation (1 byte): 

This byte is the Interphase product variation code. This value is represented as one 
ASCn character. This value is valid after the completion of a controller reset. 

Firmware ItevisiiMi Levci (3 bytes): 

These three bytes are the revision level of the installed firmware. This value is 
represented as a 3-character ASCII string. The most significant character appears first. 


RESERVED 


RESERVED 


PRODUCT CODE 


PRODUCT CODE 
RESERVED 


RESERVED 


RESERVED 


RESERVED { FIRMWARE REVISION LEVEL 

FIRMWARE REVISION LEVEL 
RESERVED 


FIRMWARE RELEASE DATE 


RESERVED 
SIZE OF BUFFER 


RESERVED 


PRIMARY SCSI BUS ID 


SECONDARY SCSI BUS ID 


LAST PRIMARY DEVICE SELECTED 


LAST SECONDARY DEVICE SELECTED 


PRIMARY PHASE SENSE 


RESERVED 


SEC. PHASE SENSE/PRINT STATUS 
DAUGHTER BOARD ID 


RESERVED { SOFTWARE DIP SWITCH 

FROZEN WORK QUEUES REGISTER 


RESERVED 


Figure 21. Conjuration Status Block 
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This value is valid after the completion of a controller reset. 

Firmware Release Date (8 bytes): 

These 8 bytes are the release date of the installed firmware. This value is represented as 
an 8-character ASCII string. The format is MMDDYYYY. For example, a release date 
of January 15, 1^ would be 01151989. It is valid after the completion of a controller 
reset. 


Size of Buffer (2 bytes): 


1 nese bytcS arc ihc amviiini on-iA^aid bufter expressed m IR increments. This 
value is represented as a four-di^t hexadedmal number. For example, a 128K RAM 
buffer would be 0080. This value is valid after the completion of a controller reset. 


Primary SCSI Bus ID (1 byte): 

This byte is the current bus ID for the primary SCSI bus. This value is represented as a 
1-dig^t hexadedmal number. This value will default to the bus ID encoded in the on¬ 
board switches at the completion of a controller reset. This value will be updated at the 
completion of an Initialize Controller command. 

Secondary SCSI Bus ID (1 byte): 

This 1-digit hexadecimal value is the current bus ID for the secondary SCSI bus. It 
defaults to the bus ID encoded in the jumpers on the SCSI dai^ter card at the 
completion of an Initialize Controller command. (For details on these jumpers, see page 
13.) 


Last Primary Device Selected (1 byte): 

This byte contains the SCSI ID of the last primary SCSI bus device selected by the Jaguar. 
This field is updated every time the Jaguar selects or reselects a device on Port 0. 

Last Secondary Device Selected (1 byte): 

This byte contains the SCSI ID of the last secondary bus device selected by the Jaguar. This 
field is updated every time the Jaguar selects or reselects a device on Port 1. 

Primary Phase Sense (1 byte): 

This t^e contains the status of the primary SCSI bus. The primary phase sense register 
contains a copy of Port 0*s Fujitsu 87030 phase sense re^er. This copy is updated 
approximately every 27 to 35msec. The signals m the register are shown below: 


07 06 05 04 03 02 01 00 

I REQ I ACK I ATH | SEL { BSY { NSG j C/0 i I/O | 


Figure 22. SCSI Bus Status Byte 

The above si gnals are active hi gh, and each corresponds to a signal on the SCSI bus. For a 
complete description of the signals, please refer to the SC^I specification or the 87030 user’s 
guide. 
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Secondary Phase Sense/Printer Status (1 byte): 

If your board has a SCSI daughter card, this byte shows the status of the secondary SCSI 
bus status. If you are using a printer port dau^ter card, the byte shows the status of the 
printer. If the former is the case, the byte is an image of the port’s Fujitsu 87030 phase 
sense register. The format of this register is shown in the preceding fi^e. This copy is 
updated approximately every 27 to 35msec. This renter is identical in operation to the 
primary SCSI port register above. 

If the printer port is installed, this register contains the printer status. This register will be 
updat^ at the completion of any print command or approximately every 27 to 35msec. The 
bit definition of this renter is dependent on whether the interface is Dataproducts or 
Centronics type. The format of that register is as follows; 


Meaning of Register for Dataproducts Printer: 


D7 D6 D5 D4 03 02 01 00 



I I i.. 

! I..! 
+- 


READY 

ONLINE 

PARITY ERROR 
CABLE ON 
BOTTOM OF FORM 
TOP OF FORM 
PAPER MOVEMENT 
CONFIGURATION JUMPER 


= DATAPRODUCTS 


Meaning of Register for Centronics Printer: 
07 06 05 04 03 02 01 00 



i 1.:: 
♦-- 


FAULT 
SELECT 
PAPER EMPTY 

RESERVED MAY BE 'O' OR •1• 

RESERVED MAY BE 'O' OR '1' 

RESERVED MAY BE 'O' OR '1' 

BUSY 

CONFIGURATION JUMPER '0* = CENTRONICS 


Figure 23. Printer Status Re^er 


Daughter Card ID (1 byte): 


The daughter card ID field contains a value from 0x0 to 0x7 that indicates the type of 
daughter board installed (if any). The meaning of the codes is as follows: 
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Table 7. Daughter Card ID 


Code 

Meaning 

0x7 

No daughter card is installed 

0x6 

SCSI daughter card 

0x5 

(reserved) 

0x4 

Printer daughter card 

0x3 

(reserved) 

0x2 

(reserved) 

0x1 

(reserved) 

0x0 

(reserved) 


Software DIP Switch (1 byte): 

This field reports the status of features set using Swtch Block SW2. This switch block is 
only provided on Jaguars with the board layout shown on page 9. Boards that do not have 
the switch will report the value of a location in the firmware that performs the same 
function. The following functions are presently defined: 


D7 06 05 04 03 02 01 00 


! ! 


I ! 



I 

+• 



0 - Reset SCSI bus on pouer*up 
1 - Oo not reset SCSI bus on power-up 
0 - Execute normal power-up test; 

clear SYSFAIL* before test 
1 - Execute extended power-up test; 

clear SYSFAIL* after passing test 


H Reserved 


Figure 24. Software Configuration Switch Settings Reported in 
Configuration Status Block 


Frozen Work Queues (2 bytes): 


This re^er provides Work Queue frozen status for the Jaguar’s 14 Work Queue’s, 1 -14. 
(Work Queue 0 cannot be frozen.) The Jaguar will set a 1 in the Work Queue’s bit position 
if the queue is frozen. The format of the register is as follows: 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


I 

+■ 


I I 


I I I I 


I I 

! i- 


I 

+ 


+ 


WORK QUEUE 0 
WORK QUEUE 1 
WORK QUEUE 2 
WORK QUEUE 3 
WORK QUEUE 4 
WORK QUEUE S 
WORK QUEUE 6 
WORK QUEUE 7 
WORK QUEUE 8 
WORK QUEUE 9 
WORK QUEUE 10 
WORK QUEUE 11 
WORK QUEUE 12 
WORK QUEUE 13 
WORK QUEUE 14 
RESERVED 


NOTE: Bits 16 - 31 of the Frozen Work Queues Register are 
reserved. 


Figure 25, Frozen Work Queues Register 
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4 

VMEbus INTERRUPTS 


OVERVIEW 

At the completion of a command (either successful or terminated with an error or with an 
exception), the Jaguar notifies the host by generating a Command Complete Interrupt on 
the VMEbus. The Jaguar can respond to the VMEbus Interrupt Acknowledge Cycle with 
different Interrupt Vectors based on the cause of the interrupt. (See lOPB Format.) But for 
those VMEbus systems that allow only one interrupt vector per device, the host can still 
determine the source of the interrupt by checking the status bits in the Command Response 
Status Word and the Work Queue Number found in the Command Response Block. 

The hardwiire driving the VMEbus interrupt line is cleared at the completion of the 
VMEbus Interrupt Acknowledge Cycle. However, a Clear Interrupt operation must also be 
executed by the host to notify the Jaguar that the interrupt has been properly serviced by the 
host and that the Jaguar may now post its next interrupt. The host does this by clearing the 
CRBV bit in the Command Response Block. (See the Command Response Status Word in 
the Command Response Block, page 36). 


NOTE: Any information that the host needs from the Command Response Block must be 
aaissed before it clears the CRBV bit in the Command Response Status Word. 
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I/O PARAMETER BLOCKS AND COMMANDS 


OVERVIEW 


The MACSI software interface of the Jaguar can handle two distinct types of lOPBs: SCSI 
lOPBs and Control lOPBs. SCSI lOPBs are commands that are sent to either the attached 
SCSI devices or to the printer port (if used). Control lOPBs are commands for the Jaguar 
itself (such as an initialization command) t^t result in local Jaguar action only. 

The follovnng commands are supported by the Jaguar: 


Table 8. Jaguar Command Set 


SCSI lOPBs 


Command Code 


SCSI Pass-Through 
SCSI Reset 
Printer Port 


(0x20) 

(0x22) 

(0x23) 


Control lOPBs 


Perform Diagnostics 

(0x40) 

Initialize Controller 

(0x41) 

Initialize Work Queue 

(0x42) 

Dump Initialization Parameters 

(0x43) 

Dump Work Queue Parameters 

(0x44) 

Bus Status Inquiry 

(0x45) 

Command Status Inquiry 

(0x46) 

Cancel Command Tag 

(0x48) 

Flush Wcwk Queue 

(0x49) 

Initialize Printer Port 

(0x4A) 

Restart Controller 

(0x4B) 

Device Reinitialize 

(0x4C) 

Issue Bus Device Reset Message 

(0x4D) 

Issue Abort Message 

(0x4E) 


In general, SCSI lOPBs are issued to a specific device via its assigned work queue (Work 
Queue 1 - 14). Each work queue must be separately initialized before commands can be 
issued to it Control lOPBs must be issued through the Master Command Entry to Work 
Queue 0. 

NOTE: The SCSI Reset command can be issued to either a specific device or through the 
Master Command Entry. Refer to the command description (p. 55) for details. 

For ease of reference, each command in this chapter starts on a new page. 
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SCSI PASS-THROUGH (0x20) 

The SCSI Pass-Through lOPB provides all of the information the Jaguar needs to send a 
command to a specific SCSI peripheral on either of the SCSI buses. The lOPB’s size can be 
adjusted to accommodate different SCSI command lengths. 

The figure below shows the format of the SCSI Pass-Through lOPB when used to issue a 
12-byte SCSI command. 


word # 



0x0 

Ccnnsfx! Cede (0x20) 

0x1 

Conmand Options 

0x2 

RETURN STATUS 

0x3 

Reserved 

0x4 

Normal Cotnpletion Vector ] Error Completion Vector 

0x5 

Interrupt Level 

0x6 

Reserved 

0x7 

LNK*j RSRV } TT 

j NT { Address Modifier 

0x8 


Buffer Address --- 

0x9 

(or scatter/gather list address*) 

OxA 




Maximum Transfer Length 

OxB 

(or scatter/gather element count*) 

GxC 


Reserved 

0x0 

(or scatter/gather transfer count*) 

OxF 

Unit Address 

0x10 

SCSI Byte 0 

1 SCSI Byte 1 

0x11 

SCSI Byte 2 

1 SCSI Byte 3 

0x12 

SCSI Byte 4 

1 SCSI Byte 5 

0x13 

SCSI Byte 6 

1 SCSI Byte 7 

0x14 

SCSI Byte 8 

{ SCSI Byte 9 

0x15 

SCSI Byte 10 

1 SCSI Byte 11 


* Scatter/gather operations only. 

NOTES: Fields set in bold capital letters are returned values. 

All other values are host provided. Reserved fields 
nust be cleared to 0 by the host. 

Figure 26. SCSI Pass-Through lOPB 
for 12-byte SCSI Command 

SCSI commands of other lengths are formed by appending the appropriate number of bytes 
at Word 10. The Jaguar examines the group cc^ field of the operation code m the SCSI 
Command DescriptOT Block (SCSI Byte 0) to find the length of the Command Descriptor 
Block. If Group 0,1, or 5 commands arc used, the lengths will be known to be 6, 10, or 12 
bytes. In these cases, clear the lOPB Length field of ±e corresponding Command Queue 
entry to ’O’. 
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If a vendor-unique SCSI command (Group 6 or 7) is used, the lOPB Length field in the 
corresponding Command Queue en^ must contain the length of the lOPB in words. The 
Jaguar will then calculate the Command Descriptor Block length by subtracting the 
overhead of the lOPB (0x10 words) from the length specified in the Command Queue entry. 


The remainder of this section describes the function of each field in the SCSI Pass-Through 
lOPB. 


HOST-PROVIDED lOPB FIELDS 


The following information mu^ be provided in the lOPB for the SCSI Pass-Through 
command: 


♦ Command Code (2 bytes) 

This field must be set to 0x20 to execute the SCSI Pass-Through command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) !dIR| (Reserved) { SS{ SG{ lEj 


1^ igure 27. SCSI Pass-Through Command Options 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bh disables the Command Complete interrupt. 

Bit 1 Scatter/Gather (SG): 

This bit should only be set if the a>mmand involves a scatter/gather operation. When 
scatter/gather is enabled, the following fields are defined differently tl^ for non- 
scatter/gathen Address Modifier/Memory Type/Transfer Type, Buffer Address, 
Maximum Transfer Length, and the Reserved field at Words (h£ - OxD. For a detailed 
discussion, please refer to ''Scatter/Gather Operations,** p. 131. 

Bit 2 Suppress Synchronous Transfers (SS): 

Setting this bit in the first pass-through command sent to a device causes the Jaguar to 
disable synchronous transfers with th^ device. The Jaguar must be reset to re-enable 
synchronous transfers with that device. This bit is provided as a work around in the event 
a device does not process the synchronous transfer request message correctly. Thus, the 
bit should be cleared for normal operations. 
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Bits 3-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 8 VMEbus Transfer Direction (DIR): 

This bit specifies the direction of the data transfer over the VMEbus, as follows: 

Table 9. VMEbus Transfer Direction for 
the SCSI Pass-Through Command 


Bit S 

VMEbus DIRECTION 

0 

Write data to the VMEbus 

1 

Read data fron the Vl^bus 


Bits 9-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I NORMAL COMPLETION VECTOR { ERROR COMPLETION VECTOR } 


Figure 28. Normal Completion Vector/Error Completion Vector 
for the SCSI Pass-Throu^ Command 


Bits 0-7 Error Completion Vecton 

This value specifies the interrupt vectcff used i^en notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion y»:tOR 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (nmmal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

] (Reserved) j LVL j 


Figure 29. Interrupt Level for the 
SCSI Pass-Through Command 
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Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3*15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Address Modifier/Memoty Type/Transfer l^pe (2 bytes) 

These bytes specify the address modifier, memory type, and transfer type to be used for all 
VMEbus transfers associated with the command. 

NOTE: Some memory systems may not support all of the options discussed for this field. 
Check the specifications of the target system to verify its capabilities. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

jlNKj RSRV j TT I MT | ADDRESS MODIFIER j 


Figure 30. Address Modifier/Memory Type/Transfer Type 
for the SCSI Pass-Through Command 


Bits 0-7 Address Modiilen 

This byte specifies the address modifier to be used by the Jaguar for all VMEbus data 
transfers associated with tlus command. 

Bits 8-9 Memory T^pe (MT): 

This 2-bit field spedfies the width of data transfers. Permitted values are as follows: 

Table 10. Memory Type for the 
SCSI Pass-Throu^ Command 


Bit 9 

Bit a 

Nenory Type 

0 

0 

(reserved) 

0 

1 

16-bit transfers 

1 


32-bit transfers 

1 

1 

Scatter/gather list resides in short I/O* 


* Valid only for scatter/gather operations 
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Bits 10-11 Transfer Type (TT): 

This 2-bit field specifies the type of data transfer to be performed. Permitted values are 
as follows: 


Table 11. Transfer Type for the 
SCSI Pass-Through Command 


Bit 11 

Bit 10 

Transfer Type 

0 

0 

Normal mode 

Q 

4 

Block mode 

1 

0 

(reserved) 

1 

1 

(reserved) 


Bits 12-14 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 

Bit 15 Unk (LNK): 

This bit should only be set if you are linking scatter/gather lists. Refer to 
“Scatter/Gather List Linking,” p. 133, for details. 


« Buffer Address (4 bytes) 

This field specifies the address at which the Jaguar will be^ the data transfer. If the Jaguar 
is addressing system memory, the value in the field is a VMEbus address. If the address is 
in short I/O, the value is an ofiset from the Jaguar’s short I/O base address. If 
scatter/gather is enabled, this field is the address of the scatter/gather list. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


BUFFER ADDRESS 

LSU (or address of scatter/gather list) 


Figure 31. Buffer Address for the SCSI Pass-Through (Command 


• Maximum Transfer Length (4 l^es) 

This field specifies the maximum number of bytes that may be transferred by the command. 
If no data is to be transferred, a Transfer Len^ of zero ^ould be specified When 
scatter/gather is enabled, this field contains the number of scatter/gather elements. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


HSU 

MAXIMUM TRANSFER LENGTH 
LSU (or scatter/gather eloaent count) 


Figure 32. Maximum Transfer Length for the 
SCSI Pass-Through Clommand 


• Reserved (4 bytes) 

Unless scatter/gather is enabled, words OxC and OxD of the SCSI Pass-Through lOPB are 
reserved and must be cleared by the host For scatter/gather operations, this field specifies 
the sum of the individual element entry counts. See “Scatter/Gather Operations,” p. 131, 
for details. 


• Unit Address (2 bytes) 

This field specifies the SCSI bus and the address of the target device. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

(Reserved) |BUS| LUN j SCSI 10 | 


Figure 33. Unit Address for the SCSI Pass-Through Command 

Bits 0-2 SCSI Device ID (SCSI ID): 

These three bits are the SCSI Bus ID (SC^I ID) of the specified device. 

Bits 3-5 Ix^cal Unit Number (LUN): 

These bits describe the SCSI Lo^cal Unit Number (LUN) of the specified device. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects ^^ch of the two SCSI buses the Jaguar uses 
^en executing the command. When the BUS bit is cleared to 0, the Jaguar executes the 
command over the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI 
bus (Port 1). 

Bits 7-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 


• SCSI Command Bytes 

The SCSI C^ommand Bytes specify the bytes that the Jaguar passes unchanged across the 
SCSI bus to the selected SCSI device. As discussed at the beginning of this se(^on, the 
Jaguar determines the length of the Command Descriptor Block by looking at the group 
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code in SCSI Byte 0 of the lOPB. 

As noted previously, the length of vendor-unique SCSI commands (Group 6 or 7) must be 
specified in the lOPB Length field of the corresp<mding Command Queue entry. The 
Jaguar calculates the Command Descriptor Blo^ length by subtracting the overhead of the 
lOPB ((hCLO words) from the length specified in the Command Queue entry. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the SCSI Pass-Throu^ command. 


• Return Status (2 bytes) 

This field provides the return status for the command, 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j PASS-BACK STATUS I ERROR CODE { 

Figure 34. Return Status for the SCSI Pass-Through Command 


Bits 0-7 Error Code: 

The Error Code byte describes the status of the controller at the end of the command 
response. Any non-zero value is an error code. A list of Jaguar error codes is provided in 

nppcuuiA 

Bits 8-15 Pass-Back Status: 

This value is the SCSI status byte returned by the target device. It is not changed by the 
Jaguar. 
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SCSI RESET (0x22) 

The SCSI Reset lOPB instructs the Jaguar to reset the SCSI bus identified by the command. 
It terminates all pending commands on the SCSI bus. A Command Complete with Error 
will be issued for each command terminated as a result of the SCSI Reset command. 

When the host issues a Reset SCSI Bus lOPB through the Master Command Entry, all 
work queues with commands active on the specified SCSI bus will have those commands 
returned with a SCSI reset error status. In addition, the work queues corresponding to 
those commands will be frozen if the Freeze Work Queue on Reset option is enabled. 

(This option is enabled when the Jaguar is initialized. For details, see the Error Recovery 
nags field in the Controller Initiaiiz^on Block, page 75.) 

Normally, this command is used only in an to attempt to recover fi'om an unusual error 
condition. 


word # 


0x0 

Conmand Code (0x22) 

0x1 

Command Options 

0x2 

RETURN STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector j Error Completion Vector 

0x5 

Interrupt Level 

0x6 

to 

0x0 

(Reserved) 

OxE 

SCSI Bus ID 


NOTES: Fields set in bold capital letters are returned values. 
All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 


Figure 35. SCSI Reset lOPB 


The following section describes the function of each field in the SCSI Reset lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the SCSI Reset command: 

• Command Code (2 bytes) 

This field must be set to 0x22 to execute the SCSI Reset command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


(Reserved) 


IE I 


Figure 36. (Command Options for the 
S(ZSI Reset Command 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to iatemipt the host upon command completion. 
Clearing the bit disables the Command (;k)mplete interrupt. 


Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j NORMAL COMPLETION VECTOR | ERROR COMPLETION VECTOR j 


Figure 37. Normal Completion Vector/Error Completion Vector 
for the SdlSI Reset Command 


Bits 0-7 Error Completion Vecton 

This value specifies the interrupt vector used ^en notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vecton 

This value specifies the interrupt vector used when notifying the host that the command 
completed ^i^out error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

i (Reserved) | LVL j 


Figure 38. Interrupt Level for the 
SCSI Reset Command 
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Bits 0>2 lotemipt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

# SCSI Bus ID (2 bytes) 

This field identifies which bus is to be reset. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

IBUS I (Reserved) { 


Figure 39. SCSI Bus ID for the SCSI Reset Command 


Bits 0-14 Reserved: 

These bits are reserved and must be cleared to 0. 

Bit 15 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the Jaguar uses 
when executing the command. When the BUS bit is cleared to 0, the Jaguar executes the 
command over the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI 
bus (Port 1). 


RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the SCSI Reset command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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PRINTER PORT lOPB (0x23) 

This command is used to issue instructions to a printer connected to the Jaguar’s printer 

port. Before issuing a Printer Port lOPB, the host must initialize the port using the TniHali7<» 

Printer Port command (sec p. 105). 

For additional information on the printer port, please refer to Chapter 6. 

The format of the Printer Port lOPB is as follows: 

word # 

0x0 

0x1 

0x2 

0x3 

0x4 

0x5 

0x6 

0x7 

0x8 

0x9 

OxA 

OxB 

OxC 

0x0 

OxE 

OxF 
to 

0x15 

NOTES: Fields set in bold capital letters are returned values. 

All other values are host provided. Reserved fields 
Must be cleared to 0 by the host. 

Figure 40. Printer Port lOPB 

The remainder this section describes the fimdion of each field in the Printer Port lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Printer Peat command: 

• Command Code (2 bytes) 

This field must be set to 0x23 to ei^cute the Printer Port command. 
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• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) jPI { (Reserved) jlE | 

Figure 41. Command Options for the 
Printer Port Command 

Bit 0 IntOTupt Enable (IE): 

Settio^ this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 8 Paper Instruction (PI): 

Setting the Paper Instruction bit causes the Jaguar to transfer all of the data specified in 
this lOPB to the printer with the Paper Instruction interface signal active. The Paper 
Instruction signal is only supported by Dataproducts printers. 

Bits 9-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 l^es) 

These two bytes specify the VMEbus haerrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I NORMAL COMPLETION VECTOR | ERROR COMPLETION VECTOR { 

Figure 42. Normal Completion Vector/Error (Completion Vector 
for the Printer Port Ck>mmand 

Bits 0-7 E>ror Completion Vecton 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8^15 Norma! Completics Vector: 

This value specifies the interrupt vector used when notifying the host that the command 
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completed without error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) | LVL | 


Figure 43. Interrupt Level for the 
Printer Port Command 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 ^ough 7 are allowed, but a level of 0 is allowed 
only Vthen interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and mu^ be cleared to 0 by the host. 

♦ Address Modifier/Memoiy Type/Transfer Tfype (2 bytes) 

These bytes spcdfy the address modifier, memory type, and transfer type to be used for all 
VMEbus transfers associated with the command. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RSRV I TT { NT | ADDRESS NOOIFIER j 


Figure 44, Address Modifier/Memory Type/Transfer Type 
for the Printer Port Command 


Bits 0-7 Address Modifien 

This byte specifies the address modifier to be used by the Jaguar for all VMEbus data 
transfers associated with this command. 

Bits 8-9 Memory Type (MT): 

This 2-bit field specifies the ^dth of data transfers. Permitted values are as follows: 
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Table 12. Memory Type for the 
Printer Port Command 


Bit 9 

Bit 8 

Hefflory Type 

iggH 

0 

(reserved) 

0 

1 

16-bit transfers 

1 

0 

32-bit transfers 

1 

1 

(reserved) 


Bits 10-11 Transfer Type (TT): 

This 2-bit field specifies the type of data transfer to be performed. Permitted values are 
as follows: 

Table 13. Transfer Type for the 
Printer Port Command 


Bit 11 

Bit 10 

Transfer Type 

0 

0 

Normal mode 

0 

1 

Block mode 

1 

0 

(reserved) 

1 

_ 

1 

(reserved) 


Bits 12-15 I^served (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 

• Buffer Address (4 bytes) 

This field specifies the address in system memory at ^ch the Jaguar will begin the data 
transfer. 

IS 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I I 

BUFFER ADDRESS — ‘ 

I LSW I 

Figure 45. Buffer Address for the Printer Port Command 

• Maximum Transfer Length (4 bytes) 

This field specifies the mayimiim number of bytes that may be transferred by the command. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


HSU 

LSW 


I 

MAXIHUH TRANSFER LENGTH 

I 


Figure 46. Maximum Transfer Leng;th for the 
Printer Port Command 

The Jaguar must perform either word (16 bit) or long word (32 bit) transfers across the 
VMEbus. Therefore, the Msodmum Transfer Length field cannot contain an odd number of 
bytes. It must be rounded up to the nearest word or long word boundary, depending on the 
size specified in the Memory Type field. 

Entering a length of zero in both the Ma ximum Transfer Length field and in the Printer 
Transfer Length field causes the Jaguar to return the lOPB with the current printer status. 

• Printer Transfer Length (4 bytes) 

Since the Jaguar can not transfer odd-byte-length data across the VMEbus, the Printer 
Transfer Length field is used to specify the exact number of bytes to be transferred to 
printer. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


PRINTER TRANSFER LENGTH 


Figure 47. Printer Transfer Length for the 
Printer Port Command 

The above field must contain the exact count of bytes to be sent to the printer and must be 
filled in on each lOPB. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Printer Port command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error co<ks is provided in Appendix C. 

• Printer Status (1 l^e) 

This field contains the state of the printer status control lines at the completion of the data 
transfer. Only those lines vdiich were enabled \dien the printer port was initialized will be 
reported (see Tnifialize Printer Port, p. 107). The definition of the bits in this field vary 
depending on the printer type, as listed below. 
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Table 14. Definition of Printer Status Bits 


Dataproducts Status Definition (Active High): 

Bit 7 ■ Software Readable Junper 1 « Dataproducts, 0 ^ Centronics 

Bit 6 ■ Paper Movesient 

Bit 5 - Top of Form 

Bit 4 ■ Bottom of Form 

Bit 3 * Cable On 

Bit 2 - Parity Error 

Bit 1 - Online 

Bit 0 ’ Ready 


Centronics Status Definition (Active High): 

Bit 7 * Software Readable Junper 1 * Dataproducts, 0 = Centronics 
Bit 6 ' Busy 

Bit 5 ’ Reserved - value returned may be either 0 or 1. 

Bit 4 ' Reserved - value returned may be either 0 or 1. 

Bit 3 - Reserved * value returned may be either Q or 

Bit 2 * Paper Empty 

Bit 1 ' Select 

Bit 0 - Fault 


Returned Values for Printer Status Change Interrupt 

If status chaise interrupts were enabled when the printer port was initialized, the following 
takes place when a status change occurs. The Jaguar generates an interrupt and posts the 
information shown below to the Command Response Block. 


word # 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

0x0 

0x1 
to 
0x5 

0x6 

Figure 48. Returned Information for Printer Status Change Interrupt 

The Status Change bk (Bit 7) in the Command Response Status Word is set, and an image 
of the printer’s status lines is returned. The bits in the Printer Status field have the same 
definition as in the Printer Status field in the Printer Port lOPB (see above). The value in 
the Return Code field should be 0x90 (Printer Status Change). 

NOTE: More than one status line may change in a single interrupt, so the entire status 
should be verified by the host. 


COMMAND RESPONSE STATUS WORD 


(Reserved) 


PRINTER STATUS | RETURN CODE 
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PERFORM DIAGNOSTICS (0x40) 

The Perform Diagnostics command causes the Jaguar to perform a set of self-diagnostic 
tests that are more extensive than those performed during the power-up self test. These self¬ 
diagnostic tests include an extensive RAM test (scratchpad, buffer, and event RAM). All of 
the tests are performed, and then the status of each test is reported back in the Command 
Response Block. Due to the nature of these tests, the Perform Diagnostics command cannot 
be executed while the Jaguar is operating. The Jaguar returns an error if this command is 
issued while ANY other command is queued. 

Since it takes several minutes for the Jaguar to complete such a thorough self-diagnostic 
routine (and due to the relative completeness of the power-up self tests), this command 
probably should nc^ be used as part of the normal initialization routine in a system driver. 

The Perform Diagnostics command must be issued through the Master Command Entry to 
Work Queue 0. 

In all cases, a test result of OxFFFF indicates a successful test. Any other value indicates an 
error code. 

word # 

0x0 

0x1 
to 
0x0 

OxE 

OxF 

0x10 

0x11 

0x12 

0x13 

NOTES: Fields set in bold capital letters are returned values. 

All other values are host provided. Reserved fields 
Must be cleared to 0 by the host. 

Figure 49. Perform Di^nostics lOPB 

The remainder of this section describes the func^on of each field in the Perform Diagnostics 
lOPB. 


HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Perform Diagnostics command: 


• Command Code (2 bytes) 

This field must be set to 0x40 to execute the Perform Diagnostics command. 
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RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Perform Diagnostics command: 

• ROM Test Result (2 bytes) 

These bytes return the status of the ROM Test. 

• Scratchpad RAM Test Result (2 bytes) 

These bytes return the status of the Scratchpad RAM Test. 

• Buffer RAM Test Result (2 bytes) 

These bytes return the status of the Buffer RAM Test. 

• Event RAM Test Result (2 bytes) 

These bytes return the status of the Event RAM Test. 

• Primary SCSI Port Register Test (2 bytes) 

These bytes return the status of the Primary SCSI Port Register Test. 

• SCSI Secondary Port Register Test (2 bytes) 

These bytes return the status of the SCSI Secondary Port Register Test. 
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mmALIZE CONTROLLER (0x41) 

The Initialize Controller command configures the Jaguar for use m a particular system. The 

host must issue this command before the Jaguar can engage in any activity on the SCSI bus. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB for the Initialize CoiUroiler command is: 

word # 

0x0 
0x1 
0x2 
0x3 
0x4 
0x5 
0x6 
0x7 
0x8 
0x9 
OxA 
OxB 
OxC 
0x0 


The remainder of this section describes the hmction of each field in the Initialize Controller 
lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Initialize Controller command: 

• Command Code (2 l^es) 

This field must be set to 0x41 to execute the Initialize Controller command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 



66 
















5 lOPBs and Commands 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

(Reserved) jlE } 


Figure 51. Command Options for the 
Initialize Controller Command 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{ NORMAL COMPLETION VECTOR j ERROR COMPLETION VECTOR j 

Fig;ure 52. Normal Completion Vector/Error Completion Vector 
for the Initialize Controller Command 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 N<H*mal Completion VectoR 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or mth error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) | LVL j 


Figure 53. Interrupt Level for the 
TnirialiTc (Controller (Command 
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® Address J 


Bits 0-2 Interrupt Level (LVL): 

These bits set the intemipC level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 Uirough 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 


Bits 3-15 Reserved: 


These bits are reserved and must be cleared to 0 by the host. 


lodifler/Menioiy Tjfjv/Transfcr Tjj#c (2 bytes) 

These bytes spedfy the address mochfier, memory type, and transfer type to be used for all 
VMEbus transfers associated with the command. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RSRV I TT i NT I ADDRESS MODIFIER { 


Figure 54. Address Modifier/Memory Type/Transfer Type 
for the InirialiTe Controller Command 

Bits 0-7 Address ModiHen 

This byte must be cleared to 0x00 in the Initialize Controller Command. 

Bits 8-9 Memory Type (MT): 

The only valid entry in this 2-bit field is 0x3 (data is located in short I/O space). 

TaUe 15. Memory Type Field for the 
Initialize ControUer Command 


Bit 9 

Bit 8 

Monory Type 

0 

0 

(reserved) 

0 

1 

(reserved) 

1 

0 

(reserved) 

1 

1 

Dsts is contained in short I/O 


Bits 10-11 Transfer Type (TT): 

This 2-bit field must be cleared to 0. 

Bits 12-15 Resoved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 
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• Buffer Address (4 bytes) 

This field contains the offset of the Contrdler Initialization Block from the short I/O base 
address. 


15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

t |i|§y 

BUFFER ADDRESS 


Figure 55. Buffer Address for the Controller Initialization Block 


• Maximum Transfer Length (4 l^es) 

This field spedfies the maximum number of bytes that may be transferred by the command. 


15 14 13 12 
HSU 
LSU 


11 


10 9 8 7 6 5 4 


HAXIMUM TRANSFER LENGTH 


3 


2 


0 


I 

I 

I 

I 


Figure 56. Maximum Transfer Length for the 
Initialize Controller Command 
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CONTROLLER INITIALIZATION BLOCK 

The Buffer Address of the Tnirialiy/* Controller lOPB points to a list of initialization 
parameters called the Controller Initialization Block (CIB). The host must assemble the 
Controller Initialization Block in the Host Usable Space (HUS) before issuing the Tnitialiyp 
Controller command- Once it issues the Initialize Controller command, the host cannot 
modify the CIB until it receives a Command Complete interrupt for the initialize command. 

The format of the Controller Initialization Block is as follows: 

word # 

0x0 
0x1 
0x2 
0x3 
0x4 
0x5 
0x6 
0x7 
0x8 
0x9 
OxA 
OxB 
OxC 
0x0 
OxE 
OxF 
0x10 
0x11 
0x12 
0x13 


NUMBER OF COMMAND QUEUE ENTRIES IN SHORT I/O 


DMA BURST COUNT 


CONTROLLER NORMAL COMPLETION LEVEL/VECTOR 


CONTROLLER ERROR COMPLETION LEVEL/VECTOR 


PRIMARY SCSI BUS 10 


SECONDARY SCSI BUS ID 


COMMAND RESPONSE BLOCK OFFSET 


SCSI SELECTION TIMEOUT (IN MILLISECONDS) 


WORK QUEUE 0 COMMAND TIMEOUT 


VMEBUS TIMEOUT (0 = lOOmsec TIMEOUT) 


(Reserved) 


OFFBOARD CRB MEMORY TYPE/TRANSFER TYPE/AOORESS MOO. 


HOST MEMORY ADDRESS 
FOR OFFBOA») COMMAND RESPONSE BLOCK 
(if offboard CRB is being implemented) 


ERROR RECOVERY FLAGS 


(Reserved) 


Figure 57. (ZlontroUer Initialization Block 


The following is a description of each field in the Controller Initialization Block. 

• Number of Command Queue Entries (2 bytes) 

This field sets the number of entries in the Clommand Queue. The dlommand Queue must 
have at least one entry. The maximum number of entries varies greatly depending on the 
application. If you are nsing onboard lOPBs, which rctjuire that both the Command Queue 
entry and its corresponding lOPB be written to Host Usable Space in short I/O, the 
maximum number of entries is relatively limited. A typical setup for onboard lOPBs is a 
10-entry (Command Queue. (Note, however, that each CQEAOPB only reside in short I/O 
for a very short period of time before being transferred into the appropriate work queue.) 
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A much larger Command Queue is allowed in applications using ofiboard lOPBs, in which 
the Jaguar DMAs Command Queue cntries/IOPBs directly from system memory into the 
appropriate work queue. (See “Offboard lOPBs,” Chapter 6.) Nevertheless, the size of the 
Command Queue is sdll application-dependent. The maximum number of Command 
Queue entries in a setup using offboard lOPBs typically ranges from 60 to 100 entries. 

• DMA Burst Count (2 bytes) 

The DMA Burst Count specifies, in bytes, the number of VMEbus transfers performed in a 
single burst before releasing and re-requesting the bus. The maximum burst values are 128 
(512 -r 4) for 32-bit transfers or 256 (512 ^ 2) for 16-bit transfers. Setting the burst count to 
0 will specify the majdmum burst size, VMEbus transfers are either 16-bit or 32-bit; 
therefore, the burst count should be a byte multiple of the transfer size (i.e. 2,4,6...256 for 
16-bit transfers or 4,8,12,..128 for 32-bit transfers). 

• Controller Normal Completion Level/Vector (2 bytes) 

This field specifies the interrupt level and vector that the Jaguar will use when reporting the 
normal completion of the following two commands: 1) Flush All Queues and Report, and 2) 
Flush All Queues. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

! RSRV in; IV I 


Figure 58. Controller Ncxinal Comj^etioa Level/Vector 


Bits 0-7 Intermix Vector (IV): 

These bits set the Interrupt Vector used by the Jaguar when reporting normal controller 
interrupts. 

Bits 8-10 IntOTupt Levd (IL): 

These bits are the interrupt level used by the Jaguar when reporting normal controller 
interrupts. The host sets these bits and the Jaguar does not modify them. 

Bits 11-15 Reserved (RSRV): 

Bits 11 through 15 are reserved and should be cleared to 0 by the host. 


• Controller Error Completion Level/Vector (2 l^es) 

This field specifies the interrupt level and vector that the Jaguar will use when reporting a 
variety of controller errors. Such errors will not generate an interrupt if the interrupt level 
is set to 0. However, the board will still report such errors to the Command Response 
Block. For additional information on this field, please refer to the discussion in Chapter 6 
(p.128). 
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15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

1 RSRv I iL ; IV ; 

Figure 59. Controller Error Completion Level/Vector 

Bits 0-7 Interrupt Vector (IV): 

This byte is the Interrupt Vector used by the Jaguar when reporting Controller Error 
Interrupts, 

Bits 8-10 Interrupt Level (IL): 

These bits set the Interrupt Level used by the Jaguar when reporting the Controller 
Error Interrupts. 

Bits 11-15 Reserved (RSRV): 

Bits 11 through 15 are reserved and should be cleared to 0 by the host. 

• Primary SCSI Bus ID (2 bytes) 

The Primary SCSI Bus ID specifies the ID the Jaguar uses for the SCSI bus address on Port 
0. The Jaguar can either use its default ID or it may use the value given in bits 0 through 2. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RSRV jOFTj ID I 

Figure 60. Primary SCSI Bus ID 


Bits 0-2 Primaiy SCSI Bus ID (ID): 

If Bit 3 (DPT) is cleared, the value stored in this field will be used by the Jaguar as the 
Primary SCSI Bus ID. lliis field may have any value from 0x0 to 0x7. 

Bit 3 Default (DFT): 

Setting the Default bit to *V enables the Jaguar to use the default ID specified by Switch 
Block SWl (see page 17). Gearing the Default bit causes the Jaguar to use the ID 
specified in the ID field (bits 0-2) of this word. 

Bits 4-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host 

• Secondary SCSI Bus ID (2 bytes) 

The Secondary SCSI Bus ID specifies the ID the Jaguar uses for the SCSI bus address on 
Port L The Jaguar can either use its default ED or it may use the value given in bits 0 
through 2. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


RSRV 


|0FT| ID } 


Figure 61. Secondary SCSI Bus ID 
Bits 0-2 Secondary SCSI Bus ID (ID): 

The host uses these 3 bits to specify the SCSI ID the Jaguar is to use for Port 1 when 
the DPT bit is ‘O’. This field may have any value from 0x0 to 0x7. 

Bit 3 Default (DFT): 

Setting the Default bit to ‘1’ enables the Jaguar to use the default ID specified by the 
SCSI daughter card’s jumpers (refer to page 13). Clearing the Default bit causes the 
Jaguar to use the ID spedfied in the ID field (bits 0-2) of this word. 

Bits 4-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 


• Command Response Block Offset (2 bytes) 

The Command Response Block Offset word specifies the starting address of the Command 
Response Block. By setting the Command Response Block Ofiset, the host is also specifying 
the length of the largest lOPB that can be transferred to the Jaguar. The largest lOPB is 
equal to the offset of the Controller Specific Spa<^ (0x788) minus the Command Response 
Block Offset, minus 12 bytes. If the Command Response Block Off^t is 0x73C, for example, 
the largest lOPB cannot exceed 64 bytes (0x788 - 0x73C - OxC). 

The Command Response Block Offset must allow for a Command Response Block of at 
least 18 bytes so that there will always be enough room in the Command Response Block to 
include the status bytes of the returned lOPB. Attempting to use a Command Response 
Block Offset that would result in a Command Response Block of less than 18 bytes will 
result in the Initialize Controller (Command completing with an error. 


• SCSI Selection Timeout (4 bytes) 

The selection timeout causes an lOPB to be terminated with an error status if a device does 
not respond to selection within the programmed period of time. It is spedfied in increments 
of 1 millisecond. The same value is used for all devices. A value of ‘0’ specifies an infinite 
timeout In general, selection timeouts do not require error handling. They simply prevent 
the board from becoming locked up by trying to select a device that does not exist. 

• Work Queue 0 Command Timeout (4 bytes) 

This timeout specifies a timeout value for commands issued through Work Queue 0. This 
field is spedfi(^ in increments of approdmately 256nisec. A value of 0 specifies no timeout. 
The Jaguar notifies the host of an lOPB timeout by use of the Controller Error interrupt. 
This interrupt will be used to return error status without returning the lOPB that caused the 
error. Bit 7 of the Command Response Status Word allows the allows the host to determine 
the source of the error. Also data returned in the command response block has been 
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defined to specify the type of error that has occurred. Refer to “Error Recovery Tools” in 
Chapter 6 for additional details. 

• VMEbus Timeout (4 bytes) 

This long word field specifies the length of time the Jaguar will wait for a VMEbus transfer 
to complete. A value of ‘0’ specifies a timeout of 100 milliseconds. Any other value specifies 
a timeout value in increments of approximately 30 milliseconds. 

• Offboard Memory Type/Transfer lype/Address Modifier (2 bytes) 

This field is intended for applications ^ch use the Jaguar’s oSboard lOPB feature (see 
“Offboard lOPBs” m Chapter 6. If this field and the Offboard Command Response Block 
Address field (below) are ’O’, the Jaguar will post the Command Response Block to the 
short I/O space only. If these fields are non-zero, then the Jaguar will also post the 
Command Response Block to the specified offboard address. 

The Offboard Command Response Block Memory Type/Transfer Type/Address Modifier 
field are used when writii^ the Command R^ponse Block to system memory. The format 
of this field is as follows. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j RSRV I TT i MT j ADDRESS HQOIFIER | 


Figure 62. Memory Type/Transfer Type/Address Modifier 

r__ 

iUi vyiiiAJiUU xvTOpuuac 

Bits 0<7 Address Modifien 


This byte is the address modifier used for writing the Command Response Block to 
system memory. This byte is not changed by the Jaguar. 

Bits 8-9 Memory Type (MT): 

This two-bit field specifies the data transfer memory width used to write to the offboard 
Command Response Block. 

Table 16. Memory Type Field for Offboard Command Response Block 


Bit 9 

Bit 8 

Memory Type 

0 

0 

(reserved) 

0 

1 

16-bit transfers 

1 

0 

32-bit transfers 

1 

1 

(reserved) 


Bits 10-11 Transfer Type (TT): 

This two-bit field specifies the type of transfer performed. 
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Table 17. Transfer Type Reid 
for Ofift)oard Command Response Block 


Bit 11 

Bit 10 

Transfer Type 

0 

0 

Normal mode 

0 

1 

Block mode 

1 

0 

(reserved) 

1 

1 



Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host 


• Host Memory Address for OfEboard CRB (4 bytes) 

This field is intended for applications which use the Jaguar’s offboard lOPB feature (see 
“Offboard lOPBs” in Chapter 6). This address is used to write the Command Response 
Block to system memory. As noted above, if this field and the Offboard Command 
Response Block Memory Type/Transfer Type/Address Modifier field are both ’O’, the 
Jaguar will post lOPBs to the onboard Command Response Block only. 

• Error Recovery Flags (2 bytes) 

This field is used to control error recovery features. Currently, one option — Freeze Work 
Queues on SCSI Reset— is supported: 


BIT 15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


I 

I 


I 

I 


I I 


I I 
\ \ 


I I I I i I I I I I I I I 


i I I I I I I I I I I I I 
\\\\\\\\\\\\\ 



FREEZE WORK QUEUES 
ON SCSI RESET 

RESERVED 


Figure 63. Error Recovery Options in Controller Initialization Block 

Setting Bit 0 causes the Jaguar to freeze a work queue if a Reset occurs on the SCSI bus 
while a command is active on the bus from that work queue. With this feature enabled, the 
host ‘*knows” the work queue is frozen if a command is returned from the queue with a 
SCSI bus reset error status. This allows it to dedde how to handle the SCSI reset before 
permitting new commands to be sent to the device. This is the preferred mode of 
operation. In general, the bit should only be cleared if you need to maintain driver 
compatibility \tith earlier firmware that did not freeze work queues after a SCSI reset had 
terminated a command from that queue. Refer to Chapter 6, “Error Recovery Tools”, for 
more information. 
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RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Initialize Controller command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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INITIALIZE WORK QUEUE (0x42) 

The Initialize Work Queue command is used to configure Work Queues 1 —14. Each work 
queue must be initialized with a separate Initialize Work Queue command. 

This command must be issued through the Master Command Entry to Work Queue 0. 

NOTE: Work Queue 0 is auto-initialized by the Jaguar upon power-up and cannot be 
reinitialized. 

The format of the Initialize Work Queue lOPB is as follows: 


word # 


0x0 

CoRsiend Code (0x42) 

0x1 

Conmand Options 

0x2 

RETURN STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector | Error Completion Vector 

0x5 

Interrupt Level 

0x6 

to 

0x0 

(Reserved) 

OxE 

Work Queue Nunber 

1 

OxF 

Work Queue Options 

0x10 

Nunber of Work Queue Slots 

0x11 

(Reserved) 

0x12 

Commwid Timeout 

0x13 

(Reserved) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 


Figure 64. Initialize Work Queue lOPB 

The remainder of this section describes the function of each field in the Initialize Work 
Queue lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Initialize Work Queue command: 

• Command Code (2 bytes) 

This field must be set to 0x42 to execute the Initialize Work Queue command. 
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• Command Options (2 bytes) 

This 5eld contains the options for this commaiuL The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) jlE | 

Figure 65. Command Options for the 
Initialize Work Queue Command 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I NORMAL COMPLETION VECTOR | ERROR COMPLETION VECTOR { 


Figure 66. Normal Completion Vector/Error Completion Vector 
for the Initialize Work Queue (Command 


Bits 0-7 EhTMT Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector 

This value specifies the interrupt vector used when notifying the host that the command 
completed v^out error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

} (Reserved) } LVL } 


Figure 67. Interrupt Level for the 
Initialize Work Queue Command 


Bits 0-2 Interrupt Level (LVL); 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
mterrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


• Work Queue Number (2 bytes) 


This number identifies which work queue to initialize. Each work queue must be assigned a 
unique number. Valid entries in this field are 0x0 - OxF to initialize Work Queues 1 - 14, 
respectively. 


- Tfuiiv v^ucuc ujics) 


This field is used to set a variety of options this work queue. 

15 14 - 4 3 2 1 0 

I lUQ j (Reserved) jPE |FZEjRSRV| AEj 


Figure 68. Initialize Work Queue (Command Options 
Bit 0 Abort Enable (A£): 

Setting Bit 0 enables the Jaguar to abort all lOPBs in the work queue, and all lOPBs in 
the Command (Jueue entry de^ed for the work queue, v^en an lOPB from this queue 
completes vvith an error. 

Clearing the bit disables the aborting of remaining queue entries when one command 
terminates with an error. (Sec Queue Entry Control Re^er, Abort Acknowledge bit). 


Bit 1 Reserved (RSRV): 

This bit is reserved and must be cleared to 0 by the host. 

Bit 2 Freeze on Error (FZE); 

The Freeze Work bit (FZE) is set during the Work Queue Init command. This attribute 
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will be in effect for that queue only. All commands that do not return a good stattis will 
freeze the queue. When the host sees a command return from a work queue that has 
Freeze on Error enabled with a SCSI device error, the host must unfreeze (thaw) the 
work queue after taking the error handling steps needed for that particular error. 

The frozen work queue is unfrozen by selecting that work queue number in the Thaw 
Queue Renter and then settii^ Bit 0 of that register. The Jaguar will clear the register 
to acknowledge the thawing of the work queue. The Thaw Work Queue Status Register 
is located in the fourth word of the Master Control/Status Block. 

Refer to Chapter 6, “Error Recovery Tools”, for a discussion of freeze/thaw work queue 
operation. 

Bit 3 Parity Enable (PE): 

The Parity Enable bit enables SCSI busy parity checking for commands issued from the 
work queue. 

Bits 4-14 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 15 Initialize Work Queue (IWQ): 

The Initialize Work Queue (IWQ) bit causes the Jaguar to initialize the work queue even 
if it has been previously initialized. If commands are pending when the Jaguar attempts 
to execute an Initialize Work Queue command, the Initiahze Work Queue lOPB will not 
be executed and the lOPB will return with an error status. 


• Number of Slots (2 bytes) 

This field contains the number of slots in the work queue. Each work queue can have as 
many slots as you want. However, if the total number of commands queued-up in the 
Jagu^s internal work queues reaches a certain number (approx. 100), the board will not 
accept additional commands from the Command Queue until work queue space is freed up. 
No error message is generated. 

• Command Timeout (2 bytes) 

This value specifies the maximum time that a command issued to this work queue should 
take to execute after the device has been selected. This allows each work queue (Le. SCSI 
device) to run a unique timeout value. The timeout value is used from the successful 
completion the selection phase until the completion of the command on the SCSI bus. 
This timeout includes all di^nnect periods. The timeout is specified in increments 
of approximately 256msec. That is, a value of Qxl m this field specifies a timeout period of 
approximately 256mscc NOTE: The actual value may vary bctv^n 220 and 280msec. 

If the timeout value is non-zero, the Jaguar will issue a Controller Error Interrupt when the 
timeout period eiq}ires. The Jaguar no^es the host of the command timeout by use of the 
Controller Error Interrupt This interrupt returns an error status without returning the 
lOPB that caused the error. Bit 7 of the Command Response Status Word allows the allows 
the host to determine the source of the errcMr. Also, data returned in the Command 
Response Block can be used to help determine the type of error that has occurred. Refer to 
“Command Timeout” in Chapter 6 for additional information. 
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returned values 

upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Initialize Work Queue command. 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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DUMP INITIALIZATION PARAMETERS (0x43) 

The Dump Initialization Parameters command causes the Jaguar to report its current 
initializadon/setup information to the host. This command is intended to be used primarily 
for diagnostic purposes. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB for the Dump Initialization Parameters command is shown below: 

word # 

0x0 
0x1 
0x2 
0x3 
0x4 
0x5 
0x6 
0x7 
0x8 
0x9 
OxA 
OxB 
OxC 
0x0 

NOTES: Fields set in bold capital letters are returned values. 

All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 

Figure 69. Dump Initialization Parameters lOPB 

The remainder of this sec^on describes the function of each field in the Dump Initialization 
Parameters lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Dump Initialization Parameters command: 

• Command Code (2 bytes) 

This field must be set to 0x43 to execute the Dump Initialization Parameters command. 
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• Command Options (2 bytes) 

This field contains the options for this command The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j (Reserved) }IE j 


Figure 70. Command Options for the 
Dump Tnifialiyartnn Parameters Command 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1>15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j NORMAL COMPLETION VECTOR j ERROR COMPLETION VECTOR j 

Figure 71. Normal Completion Vector/Error Completion Vector 
for the Dump Initialization Parameters Command 

Bits 0-7 Errm* Completion Vecton 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vecton 

This value specifies the interrupt vector used wiien notifying the host that the command 
completed without error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

! (Reserved) | LVL j 


Figure 72. Interrupt Level for the 
Dump Initialization Parameters Command 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command (Complete 
interrupt on the VMEbus. Values of 0 trough 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

• Memory l^e/Transfer l^e/Address Modifier (2 bytes) 

This specifies the memory type and address modifier to be used for any VMEbus transfers 
associated with the Dump Initialization Parameters command. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

i RSRV j TT j HT I ADDRESS MODIFIER | 


Figure 73. Memory Type/Transfer Type/Address Modifier 
for the Dump Initialization Parameters Command 


Bits 0-7 Address Modifier 


This byte must be cleared for the Dump Initialization Parameters command. 

Bits 8-9 Memory Type (MT): 

The only valid entry in this 2-bit field is 0x3, indicating that the data for this command is 
located in short I/O. 

Table 18. Memory Type (MT) Reid for the 
Dump Initialization Parameters Ck>mmand 


Bit 9 

Bit 8 

Memory Type 

0 

0 

(reserved) 

0 

1 

(reserved) 

1 


(reserved) 

1 

1 

Data is contained in short I/O 
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Bits 10-11 Transfer Type (TT): 
These bits must be cleared to 0. 


Bits 12-15 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host 

• Buffer Address (4 bytes) 

This field spedfies the offset into short I/O at \duch the Jaguar is to start writing the 
initialization parameter list. NOTE: The list should be written into Host Usable Space. 


15 


I 

I 

I 

I 


14 13 12 11 
HSU 
LSU 


10 98765432 


BUFFER ADDRESS 


0 


I 

I 

I 

I 


Figure 74. Buffer Address for the Dump Initialization Parameters Block 


• Maximum Transfer Length (4 bytes) 

This field specifies the manmum number of bytes that may be transferred by the command. 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


HSU 

LSU 


HAXIHUN TRANSFER LENGTH 

I 

i 


Figure 75. Maximum Transfer Length for the 
Dump Inidalizsdon Parameters Command 


RETURNED VALUES 

Upon command completion, the following informadon is provided by the Jaguar in the returned lOPB for 
the Dump Initialization Parameters command: 


• Return Status (2 l^es) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 

The Jaguar also writes the inidalizadon parameters to the secdon of short I/O specified by 
the ho^ as discussed cm the next page. 
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DUMP INITIALIZATION PARAMETERS BLOCK 

When it executes the Dump Initialization Param^ers command, the Jaguar writes the 
parameter list into short I/O, starting at the offset provided in the Buffer Address field of 
the lOPB. 

The parameter list, which has the same format as the Controller Initialization Block, is 
depicted below: 

word # 

0x0 
0x1 
0x2 
0x3 
0x4 
0x5 
0x6 
0x7 
0x8 
0x9 
OxA 
OxB 
OxC 
0x0 
OxE 
OxF 
0x10 
0x11 
0x12 
0x13 


Figure 76. Dump Initialization Parameters Block 

For an explanation of the fields in the Dump Initialization Parameters Block, please refer to 
the Controller Initialization Block (p. 70). 


NUMBER OF COMMAND QUEUE ENTRIES IN SHORT I/O 


DMA BURST COUNT 


CONTROLLER NORMAL COMPLETION LEVEL/VECTOR 


CONTROLLER ERROR COMPLETION LEVEL/VECTOR 


PRIMARY SCSI BUS ID 


SECONDARY SCSI BUS ID 


COMMAND RESPONSE BLOCK OFFSET 


SCSI SELECTION TIMEOUT (IN MILLISECONDS) 


WORK QUEUE 0 COMMAM) TIMEOUT 


VMEBUS TIMEOUT (0 > lOOmsec TIMEOUT) 


(Reserved) 


OFFBOARD CRB MEMORY TYPE/TRANSFER TYPE/ADDRESS HOD. 


HOST MEMORY ADDRESS 
FOR OFFBOARD COMMAND RESPONSE BLOCK 
(if offboard CRB is being implemented) 


ERROR RECOVERY FLAGS 


(Reserved) 
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DUMP WORK QUEUE PARAMETERS (0x44) 

The Dump Work Queue Parameters command causes the Jaguar to report the current 
parameters of an individual work queue to the host. The host provides the work queue 
number. Note that a work queue must be initialized before its parameters can be dumped. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB for the Dump Work Queue Parameters command is shown below: 

word # 

0x0 

0x1 

0x2 

0x3 

0x4 

0x5 

0x6 
to 
0x0 

OxE 

OxF 

0x10 

0x11 

0x12 

0x13 

NOTES: Fields set in bold capital letters are returned values. 

All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 

Figure 77. Dump Work Queue Parameters lOPB 

The remainder of this section describes the function of each field in the Dump Work Queue 
Parameters lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Dump Work Queue Parameters command: 

• Command Code (2 bytes) 

This field must be set to 0x44 to execute the Dump Work Queue Parameters command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as foflows: 


Comnand Code (0x44) 

Coomaid Options 
RETURN STATUS 
(Reserved) 

Normal Completion Vector j Error Completion Vector 
Interrupt Level 


(Reserved) 


Work Queue Number 
WORK QUEUE OPTIONS 


HUMBBI OF UORIC QUEUE SLOT'S 
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15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) JlE j 

Figure 78. Command Options for the 
Dump Work Queue Parameters Command 

Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1*15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I NORMAL COMPLETION VECTOR j ERROR COMPLETION VECTOR { 

Figure 79. Normal Completion Vector/Error Completion Vector 
for the Dump Work Queue Parameters Command 

Bits 0*7 Error Completion Vecton 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8>15 Nmmal Completion Vecton 

This value specifies the iiUerrupt vector used ^en notifying the host tluU the command 
completed v^out error. 

• Interrupt Level (2 l^es) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{ (Reserved) j LVL j 

Figure 80. Interrupt Level for the 
Dump Work Queue Parameters Command 
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Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 arc allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interruj^ Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


• Work Queue Number (2 bytes) 

This number identifies the work queue whose parameters are to be dumped. Legal values 
in the field are 0x1 - OxF (for Work Queues 1 -14, respectively). If you specify an 
uninitialized work queue, the command will complete with an error and an illegal parameter 
status. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Dump Work Queue Parameters command: 

• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value mdicates an 
error code. A list of valid error codes is provided in Appendix C. 

• Work Queue Options (2 bytes) 

This field contains the work queue options specified by the host when it initialized the work 
queue. 

• Number of Work Queue Slots (2 bytes) 

This field contains the number of work queue slots specified by the host when it initialized 
the work queue. 

• Command Timeout (2 bytes) 

This field contains the command timeout specified by the host when it initialized the work 
queue. 
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BUS STATUS INQUIRY (0x45) 

The Bus Status Inquiry command returns the command tag of any lOPB currently executing 
on the selected SCSI bus (Port 0 or Port 1). In addition it returns the command tags of any 
in-progress lOPBs. An in-progress lOPB is one which has been sent to a device but is not 
completed yet Information in the returned lOPB can be used to identify which lOPB and 
device is causing an error conditioiu 

During execution of this command, the Jaguar will stop all internal operations so that the 
response will reflect the state of the board at the time the Bus Status Inquiry lOPB is 
executed. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the Bus Status Inquiry lOPB is as follows: 


word # 


0x0 

Command Code (0x45) 

0x1 

Command Options 

0x2 

RETURN STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector { Error Completion Vector 

0x5 

Interrupt Level 

0x6 

ACTIVE COHNAW) TAfi 

0x7 


0x8 


to 

BUST CONNAM) TAGS 

OxE 


OxF 

Bus Selection / BUSY CGMMND TAGS (cant.) 

0x10 


to 

0x15 

BUST COflAND TAGS (cont.) 


NOTES: Fields set in bold capital letters are returned values. 

All other values are host provided. Note that word OxF in 
the above lOPS is issued with a host-provided value, but 
returned with a Jaguar-provided value. Reserved fields 
Must be cleared to 0 by the host. 


Figure 81. Bus Status Inquiry lOPB 

The remainder of this section describes the function of each field in the Bus Status Inquiry 
lOPB. 

HOST-PROVIDED lOPB FIELDS 


The following information must be provided in the lOPB for the Bus Status Inquiry command: 


• Command Code (2 bytes) 

This field must be set to 0x45 to execute the Bus Status Inquiry command. 
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• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

i (Reserved) jlE j 

Figure 82. Command Options for the 
Bus Status Inquiry Command 

Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Eiror Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 a 7 6 5 4 5 2 1 0 

i NORMAL (XMPLETION VECTOR | ERROR COMPLETION VECTOR | 

Figure 83. Normal Completion Vector/Error Completion Vector 
for the Bus Status Inquiry Command 


Bits 0-7 Error Completion Vectm^ 

This value specifies the interrupt vector used \dien notifying the hc^ of command 
completion with error. 

Bits 8-15 Normal Completion Vecton 

This value specifies the interrupt vector used \^en notifying the host that the command 
completed wkhout error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) i LVL j 

Figure 84. Interrupt Level for the 
Bus Status Inquiry Command 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 

on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Bus Selection (2 bytes) 

This field specifies which SCSI bus is the subject of the bus status inquiry. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

! (Reserved) |BUS{ RSRV | 

Figure 85. Bus Selection for the 
Bus Status Inquiry d^mmand 

Bits 0-2 Reserved (RSRV): 

These bits are reserved and must be cleared to 0 by the host. 

Bit 3 Bus: 

Clearing the Bus bit selects the primary SCSI bus (Port 0). Setting the bit selects the 
secondary SCSI bus (Port 1). 

Bits 4-15 Resoved: 

These bits are reserved and must be cleared to 0 by the host 
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RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Bus Status Inquiry command: 


9 Return Status (2 bytes) 

These two bytes hold the returned ^atus of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 

* Ai:iiVc \^uimiiailu xSg \y uj^co/ 

The Active Command Tag field contains the command tag of a SCSI Pass-Through lOPB, if 
the command is being executed on the bus at the time that the Bus Status Inquiry is issued. 

• Busy Command Tags 

The Busy Command Tags fields will contain any other currently "in-progress" lOPBs that 
may not be able to complete due to the "hung" active command There can be up to seven 
busy commands per port, (words 0x8 - 0x9, OxA - OxB, OxC - OxD, OxE - OxF, 0x10 - 0x11, 
0x12 - 0x13, 0x14 - ojdS). NOTE: The host-provided value in word OxF (Bus Selection) 
be overwritten. 
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COMMAND STATUS INQUIRY (0x46) 

This lOPB returns the state of a previously issued lOPB based on the command tag field. If 
the lOPB specified by the command tag is active on the bus, information will be returned to 
help identify the state of the SCSI activity. The Jaguar will suspend hardware operations 
undl the status of the command is found and posted. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB is as follows: 


word # 


0x0 

Command Code (0x46) 

0x1 

Command Options 

0x2 

RETURN STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector } Error Completion Vector 

0x5 

Interrupt Level 

0x6 

to 

OxF 

(Reserved) 

0x10 

0x11 

— Command Tag — 

0x12 

CCMNAND STATUS FIELD 


LAST CfSflAIS !^UE5 

0x14 

PHASE SENSE 

0x15 

(Reserved) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are Host provided. Reserved fields 
must be cleared to 0 by the host. 


Figure 86. Command Status Inquiry lOPB 

The remainder of this sec^on descr3)es the function of each field in the Command Status 
Inquiry lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the 
Command Status Inquiry: 

• Command Code (2 bytes) 

This field must be set to 0x46 to execute the Command Status Inquiry command. 
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• Command Options (2 bytes) 

This field contains the options for this command The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) |IE | 


Figure 87. Command Options for the 
Command Status Inquiry lOPB 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the (Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{ NORMAL COMPLETION VECTOR | ERROR C0fff>LETI0N VECTOR | 

Figure 88. Normal Completion Ved:or/Error Completion Vector 
for the Command Status Inquiry lOPB 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vtctan 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) j LVL \ 


Figure 89. Interrupt Level for the 
(Command Status Inquiry lOPB 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 

/>« fltA \/XiCPr|^iie \/ol|i^c 0 7 91*0 Hilfr 9 r\f A 5 e 

&AXWWA A iSL/V V/AA vuw V AW&.^Vr«M« V ulUwd VA \f VAU\/AU4^ ' OAW CrUA a AWTWA v/A \/ ao aliOvrCVA 

only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Command Status Inquiry: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 

• Command Status Field and Active Command Information (3 bytes) 

The lower byte in word 0x12 contains the returned command status. If the command is 
active, two additional bytes of information are returned in words 0x13 and 0x14, as shown 
below. 


word # 



0x12 

(Reserved) 

j COMMAND STATUS FIELD 

0x13 

(Reserved) 

1 UST COMMAND ISSUED 

0x14 

(Reserved) 

1 PHASE SENSE 

0x15 

(Reserved) 


Figure 90. Returned Helds for Ck)mmand Status Inquiry 
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Valid returned values for the Command Status Field (CSF) are as follows: 
Table 19. Returned Values for Command Status Field 


Code Explanation 

OxOI Connand not found (comnand tag did not match) 

0x02 Coninand in work queue (not executing yet) 

0x03 Comand currently active (currently on SCSI bus) 
0x04 Connand busy (currently disconnected) 

0x05 Comnand on Done Queue (the conmand is on the 

Jaguar's internal Done Queue and will have been 
received by the host before the response to 
the bus inquiry) 

0x06 Command in connand queue (still in short I/O) 


Active Command Additional Information Fields 


If the command inquired about is currently active (0x03), the state of the controller and the 
SCSI bus is also reported back in two additional fields- LCMD (Last Command Issued to 
the Jaguar’s SCSI Controller (Fujitsu 87030) and PSNS (phase sense). 


Last Command Issued . This field indicates the last command issued to the Jaguar’s SCSI 
controller (Fujitsu 87030). Valid returned values are shown below: 


Table 20. Returned Values in Last Command Field 

Code Explanation 

0x00 Bus Release 

0x01 Select Device 

0x02 Reset Attention 

0x03 Set Attention 

0x04 Transfer Data 

0x05 Transfer Data Pause 

0x06 Reset SCSI Handshake Line 
0x07 Set SCSI Handshake Line 


Phase Sense . This field indicates the current SCSI bus status. Valid returned values are 
shown below: 


Table 21. Returned Values in Phase Sense Field 


Code 

Explanation 

0x07 

Request 

0x06 

Acknowledge 

0x05 

Attention 

0x04 

Select 

0x03 

Busy 

0x02 

Message 

0x01 

Command/Oata 

0x00 

Input/Output 
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CANCEL COMMAND TAG (0x48) 

This lOPB cancels the execution of a previously issued lOPB, based on the command tag 
specified in words 10-11 of the Cancel Command Tag lOPB. Issuing the command causes 
the Jaguar to find and cancel the first command tag that matches the one given in the lOPB. 
If multiple lOPBs exist with the same command tag, only the first one found wUl be 
canceU^ If the Jaguar is unable to locate a command whose tag matches the one in the 
lOPB, it will return the Cancel Command Tag lOPB with an error. 

This command must be issued through the Master Command Entry to Work Queue 0. 

If an lOPB is cancelled and subsequent SCSI activity attempts to complete the command, 
the Jaguar will return a controller error indicating that a device has connected for which 
there is no lOPB. 

NOTE: Use of this command implies that the host uses unique command tags for all 
lOPBs residing on the board. 

The format of the Cancel Command Tag lOPB is shown below. 

word # 

0x0 

0x1 

0x2 

0x3 

0x4 

0x5 

0x6 
to 
OxF 

0x10 

0x11 

0x12 
to 

0x15 


CoRinand Code (0x48) 

Conmand Options 
RETURM STATUS 
(Reserved) 

Normal Completion Vector | Error Completion Vector 
Interrupt Level 


(Reserved) 


Command Tag 


(Reserved) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 


Figure 91. Cancel Command Tag lOPB 


The remainder of this section describes the function of each field in the Cancel Command 
Tag lOPB. 
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HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Cancel Command Tag command* 

• Command Code (2 bytes) 

This field must be set to 0x48 to execute the Cancel Command Tag command. 

• Command Options (2 bytes) 

This field contains the options for this command The bits are defined as follows: 

15 U 13 12 11 10 9 8 7 6 5 4 3 2 10 

I (Reserved) {lE { 

Figure 92. Command Options for the 
Cancel Command Tag Command 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command C]!omplete interrupt. 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Eiror Completion Vector (2 bytes) 

These two bytes specify the VMEbus interru;^ vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j NORMAL COMPLETION VECTOR { ERROR COMPLETION VECTOR { 

Figure 93. Normal Compledon Vector/Error Completion Vector 
for the C^cel Command Tag Command 


Bits 0-7 Error Completion Vecton 

This value spedfies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vecton 

This value spedfies the interrupt vector 'used when notifying the host that the command 
completed without error. 
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• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) | LVL ] 


Figure 94. Interru{< Level for the 
Cancel Command Tag Command 


Bits (K>2 Interrupt Level (LVL): 

These bits set the interrupt level used the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 ^ough 7 are allowed, but a level of 0 is allowed 
only when iaterrupts are disabled (Interru[^ Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


• Command Tag (4 bytes) 

This field spe-cifie-s command tag of the lOPB ^idiich is to be cancelled. 


j 

I 

I 


15 14 13 12 11 
MSU 
LSU 


10 9876543210 

I 

COMMAND TAG 

I 

I 


Figure 95. Command Tag Field for the Cancel Command Tag lOPB 


RETURNED VALUES 

Upon command completion, the follomng information is provided by the Jaguar in the returned lOPB for 
the Cancel Command Tag command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error axles is provided in Appendix C. 
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FLUSH WORK QUEUE (0x49) 

The Flush Work Queue command flushes all commands that have been placed in the work 
queue, as well as any commands in the Command Queue destined for the work queue. (This 
is different from the Flush Queue bits in the Master Control Register. This command 
flushes only the spedfied work queue; the Flush Queue bits in the MCR flush all the 
queues.) This command specifies the work queue number and has, as an option, the ability 
to report completion of each entry in the queue. 

This command must be issued through the Master Command Entry to Work Queue 0. 

At the completion of the Flush Work Queue command, the number of entries flushed from 
the queue be returned. The returned lOPB will also report whether any commands 
were “In Progress” when the Flush Work Queue command was executed. 

If any of the flushed commands are “In Progress”, it may be necessary to reset the SCSI bus 
in order to clear the effects of the command out of the target. To do so, issue a Reset SCSI 
Bus lOPB. 

The format of the lOPB is as follows: 


word # 


0x0 

Coonand Code (0x49) 

0x1 

Conmand Options 

0x2 

RETURN STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector { Error Completion Vector 

0x5 

Interrupt Level 

0x6 

to 

0x0 

(Reserved) 

OxE 

Work Queue Number 

OxF 

SIP|PIP| NUMBER OF ENTRIES FLUSHB) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are host provided. Reserved fields 
Must be cleared to 0 by the host. 


Figure 96. Flush Work Queue lOPB 

The remainder of this section describes the function of each field in the Flush Work Queue 
lOPB. 
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HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Flush Work Queue command: 

• Command Code (2 bytes) 

This field must be set to 0x49 to execute the Flush Work Queue command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RSRV {RPT) RSRV I IE | 

Figure 97, Command Options for the Flush Work Queue Command 


Bit 0 Intemipt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Gearing the bit disables the Command Complete mterrupt. Note that it is not necessary 
to enable this bit in order to use Bit 8 (RPT), below. 

Bits 1-7 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 8 Report Flushed Commands (RPT)! 

Setting this bit causes the Jaguar to report each command as it is flushed with a 
Command Complete Interrupt and an Error Status. Clearing the bit disables this 
function. NOTE: Only the commands that have the Interrupt Enable bit set in the 
Command Options word of their individual lOPBs will generate an intemipt as they are 
flushed. 

Bits 9-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 


• Work Queue Number (2 bytes): 

This is the number of the work queue to be flushed. The host can also flush all of the 
work queues and the Command Queue by setting the Flush Queue bits in the Master 
Control Register (see Master Control Re^er). 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{ 'normal completion vector I ERROR COMPLETION VECTOR | 

Figure 98. Normal Completion Vector/Eiror Completion Vector 
for the Flush Work Queue Command 


Bits 0-7 Error Completion Vector 

Tnis value spedfies the interrapt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

! (Reserved) | LVL | 


Figure 99. Interrupt Level for the 
Flush Work Queue Command 


Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 


RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Flush Work Queue command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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• Number of Commands Flushed/Flushed In Progress Command (2 bytes) 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{SlPjPIPj NUMBER OF COMMANDS FLUSHED { 


Figure 100. Number of Commands Flushed/In Progress 


Bits 0-13 Numbers of Entries Flushed: 

This is the number of entries that were flushed from the work queue. 

Bit 14 Primaiy Bus (Port 0) Command In Progress (PIP): 

The Jaguar sets this bit in the returned lOPB when an In Progress command is present 
on the primary SCSI bus. There can never be more than one In Progress command for 
any one work queue, but because the SCSI bus allows targets to disconnect, there can be 
multiple In Progress commands on each SCSI bus. 

Bit 15 Secondary Bus (Port 1) Command In Progress (SIP): 

The Jaguar sets this bit in the returned lOPB when an In Progress command is present 
on the secondary SCSI bus. 
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initialize printer port (0x4A) 

The Initialize Printer Port command is used to configure the printer port for the interface 
being used (Dataproducts or Centronics). In addition, it enables/disables status change 
interrupts. NOTE: The vector used for status change interrupts is stored in word 0x2 of the 
Controller Initialization Block (the lower byte of the Controller Normal Completion 
Level/Vector field). 

This command must be issued through the Master Command Entry to Work Queue 0. 

The Initialize Printer Port command can be issued at any time to reset the printer port. The 
command is issued mth the reset bit set to dear the printer port hardware. It should never 
be necessary to reset the hardware. 

The command may also be issued at any time to assert a buffer dear to the printer. Smce 
the time required for holding this signal varies &om printer to printer, the Jaguar will leave 
the line set until the host issues another Initialize Printer Port command with the bit 
cleared. 

The format of the Initialize Printer Port lOPB is as follows: 


word # 


0x0 

Conmand Code (0x4A} 

0x1 

Coinnand Options 

0x2 

RETURII STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector } Error Completion Vector 

0x5 

Interrupt Level 

0x6 

to 

0x0 

(Reserved) 

OxE 

Printer Options 

OxF 

to 

0x15 i 

1 

: (Reserved) | 


traTES: Fields set in bold cwital letters are returned values. 
All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 


F^re 101. Initialize Printer Port lOPB 


The remainder of this section describes the function of each field in the Initialize Printer 
Port lOPB. 
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HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Initialize Printer Port command; 


• Command Code (2 bytes) 

This field must be set to 0x4A to execute the Initialize Printer Port command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

(Reserved) jlE { 


Figure 102. Command Options for the 
Initialize Printer Port Command 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus intermit vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

i NORMAL COMPLETION VECTOR | ERROR COMPLETION VECTOR | 

Figure 103. Normal Completion Vector/Error Completion Vector 
for the Initialize Printer Port Command 


Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used i^en notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector 

This value specifies the interrupt vector used when notifying the host that the command 
completed without error. 
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• Interrupt Level (2 bytes) 

This field specifies the VMEbus intemiiH; level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) { LVL I 


Figure 104. Interrupt Level for the 
Initialize Printer Port Q>mmand 


Bits 0*2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a C!ommand Complete 
interrupt on the VMEbus. Values of 0 through 7 arc allowed, but a level of 0 is allowed 
only >^en interrupts are disabled (Interrupt Enable bit = 0 in the (Command Options 
word). 


Bits 3-15 Reserved: 


These bits are reserved and must be cleared to 0 by the host. 


« Printer Options (2 bytes): 


The field provides the following options: 


|RST|0/EjBC j (Reserved) { STATUS CHAN(£ INTERRUPT ENABLE { 


Figure 105. Printer Options Field for the 
Initialize Printer Port Command 


Bits 0-7 Status Change Interrupt Enable: 

This field is used to enable interrupts firom the printer status lines which the host is to 
monitor. To enable a specific status line, set the appropriate bit. The field’s bit 
definitions vary depending the printer type, as listed below: 


Table 22. Printer Status Change Interrupt Field 


Dataproducts Printers: Centronics Printers: 


Bit 7 - Reserved - 0 
Bit 6 - Reserved - 0 
Bit 5 - Reserved - 0 
Bit 4 - Reserved - 0 
Bit 3 - Cable On 
Bit 2 - Parity Error 
Bit 1 - Online 
Bit 0 - Ready 


Bit 

7 - 

Reserved - 0 

Bit 

6 - 

Reserved - 0 

Bit 

5 - 

Reserved - 0 

Bit 

4 - 

Reserved - 0 

Bit 

3 - 

Reserved - 0 

Bit 

Bit 

2 - 
1 - 

Paper Empty 
Seiect 

Bit 

0 - 

Fault 


MOTE: These signals are active high. 
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Bits 8-12 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

Bit 13 Reset (RST): 

Issuing the Tnifialirfi Printer Port command with this bit set causes the Jaguar to reset 
the printer port. The port will be ready to receive new print commands after the 
completion status has been returned to the host. 

Bit 14 Odd/Even (0/E): 

This bit applies to Dataproducts printers only. It specifies the parity polarity, as follows: 

0 = Even Parity 
1 = Odd Parity 

Bit 15 Buffer Clear/Printer Init (BQ: 

Issuing the Initialize Printer Port command with this bit set causes the Jaguar to assert a 
Buffer Clear to a Dataproducts printer or a Print Init to a Centronics printer. 

NOTE: After using Bit 15 to issue a Buffer Clear/Print Init instruction, the host must 
issue another Initialize Printer Port command with Bit 15 cleared to return to 
normal printer operations. 

RETURNED VALUES 

Upon command completion, the foUowing information is provided by the Jaguar in the returned lOPB for 
the Initialize Printer Port command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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RESTART CONTROLLER (0x4B) 

The Restart Controller command provides a method of resetting the controller and 
bypassing the power-up diagnostics. This command is analogous to a soft reset that tells the 
board to clear all current operations. 

The first action the board takes is to reset the SCSI ports. It then flushes all internal 
commands, with the exception of the Restart ControUer command. Next, the Command 
Queue pointer is reset to the base of the Command Queue. Finally, the Restart Controller 
command is returned to the Command Response Block. 

All Controller Initialization Block parameters remain intact, and the board remains in 
Queue Mode (if it was in Queue Mode when the command was issued). 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB is as follows: 


word # 


0x0 

Coofnand Code (0x48) 

0x1 

Coomand Options 

0x2 

RETURX STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector | Error Completion Vector 


In^srrupt Lsvsi 

0x6 

to 

0x15 

I (Reserved) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 


Figure 106. Restart Controller lOPB 

The remainder of this section describes the function of each field in the Restart Controller 
lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Restart Controller command: 

• Command Code (2 l^es) 

This field must be set to 0x4B to execute the Restart Controller command. 

• Command Options (2 l^es) 

This field contains the options for this command. The bits are defined as follows: 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{ (Reserved) }IE j 

Figure 107. Command Options for the 
Restart Controller Command 

Bit 0 Interrupt Enable (I£): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt 

Bits 1-15 Reserved; 

These bits are reserved and must be cleared to 0 1^ the host 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j NORMAL COMPLETION VECTOR j ERROR COMPLETION VECTOR { 

Figure 108. Normal Completion Ve^ior/Error Completion Vector 
for the Restart Controller Command 

Bits 0-7 Error Completion Vector: 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vecton 

This value specifies the interrupt vector used when notifying the host that the command 
completed v^out error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) j LVL | 


Figure 109. Interrupt Level for the 
Restart Controller Command 
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Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 


returned values 

upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Restart Controller command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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DEVICE REINITIALIZE (0x4C) 


The Device Reinitialize command clears the first connection (synchronous negotiation state) 
of a device. This causes the Jaguar to retry the synchronous message on the next selection to 
the target. This command is only necessary when a device has been disconnected from a bus 
and power cycled without the Jaguar having any information about this action. 

The format of the lOPB is as follows: 


word # 


GxG 

CCiiiSand CcdS (0x4C) 

Gxl 

Conmand Options 

Gx2 

RETUlll STATUS 

Gx3 

(Reserved) 

Gx4 

Normal Completion Vector { Error Coopletion Vector 

Gx5 

Interrupt Level 

Gx6 

to 

Gx15 I 

I (Reserved) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are Host provided. Reserved fields 
nust be cleared to 0 by the host. 


Figure 110. Device Reinitialize lOPB 

The remainder of this section describes the function of each field in the Device Reinitialize 
lOPB. 

HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Device Reinitialize command: 

• Command Code (2 l^es) 

This field must be set to Qx4C to execute the Device Reinitialize command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j (Reserved) |IE j 


Figure 111. Command Options for the 
Device Reinitialize Command 
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Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete mterrupt. 

Bits 1-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

; NORMAL COMPLETION VECTOR j ERROR COMPLETION VECTOR j 

Figure 112. Normal Completion Vector/Error Completion Vector 
for the Device Reinitialize Command 


Bits 0>7 Error Completion Vecton 

This value specifies the intemipt vector used when notifying the host of command 
completion with error. 

Bits 8*15 Normal Completion Vecton 

This value spedfies the interrupt vector used when notifying the host that the command 
completed without error. 

• Interrupt Level (2 bytes) 

This field specifies the VMEbus intemi{^ level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j (Reserved) { LVL | 


Figure 113. Interrupt Level for the 
Device Remitialize Command 


Bits 0-2 Intemi]^ Level (LVL): 

These bits set the intemipt level used by the Jaguar to assert a Command (Complete 
interrupt on the VMEbus. Values of 0 Uirough 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the d^ommand Options 
word). 
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Bits 3>15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Device Reinitialize command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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ISSUE BUS DEVICE RESET MESSAGE (0x4D) 

This message is sent from the initiator to direct a target to clear all current commands on 
that SCSI device. This message forces the SCSI device to an initial state wth no operations 
pending for any initiator. Upon recognizing this message, the target goes to the Bus Free 
phase. 

This command enables the host to reset individual devices on the bus. The host should issue 
this command after insuring that no commands are currently being executed on this device. 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB is as follows: 


word # 

0x0 

0x1 

0x2 

0x3 

0x4 

0x5 

0x6 

to 

OxE 

OxOF 

0x10 

to 

0x15 


CoRinand Code (0x40) 

Cornmand Options 
RETURN STATUS 
(Reserved) 

Normal Completion Vector } Error Completion Vector 

Interrupt Level 


(Reserved) 


Unit Address 


(Reserved) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 

Figure 114. Issue Bus Device Reset Message lOPB 


The remainder of this section describes the function of each field in the Issue Bus Device 
Reset Message lOPB. 


HOST-PROVIDED lOPB FIELDS 


The following information must be provided in the lOPB for the Issue Bus Device Reset Message command: 

• Command Code (2 bytes) 

This field must be set to 0x4D to execute the Issue Bus Device Reset Message command. 

• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

(Reserved) jlE { 


Figure 115. Command Options for the 
Issue Bus Device Reset Message Command 


Bit 0 Interrupt Enable (IE): 

Setting this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1*15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and command completion >4ith error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I NORMAL COMPLETION VECTOR | ERROR COMPLETION VECTOR j 

Figure 116. Normal Completion Vector/Error Completion Vector 
for the Issue Bus Device Reset Message Command 


Bits 0<7 Error Completion Vector 

This value specifies the interrupt vector used when notifying the host of command 
completion with error. 

Bits 8-15 Normal Completion Vector 

This value specifies the interrupt vector used when notifying the host that the command 
completed v^out error. 

• Interrupt Level (2 l^es) 

This field specifies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with error). 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I (Reserved) | LVL j 


Figure 117. Interrupt Level for the 
Issue Bus Device Reset Message Command 
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Bits 0-2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values erf 0 Uirough 7 arc allowed, but a level of 0 is allowed 
only when interrupts arc disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3-15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Unit Address (2 bytes) 

This field spedfies the SCSI bus and the address of the target device. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{ (Reserved) |BUS| LUN | SCSI ID | 


Figure 118, Unit Address for the 
Issue Bus Device Reset Message 


Bits 0-2 SCSI Device ID (SCSI ID): 

These three bits are the SCSI Bus ID (SCSI ID) of the specified device. 

Bits 3-5 Logical Unit Number (LUN): 

These bits describe the SCSI Lo^cal Unit Number (LUN) of the specified device. 

Bit 6 SCSI Bus Selection (BUS): 

The SCSI Bus Selection (BUS) bit selects which of the two SCSI buses the Jaguar uses 
when executing the command. When the BUS bit is cleared to 0, the Jaguar executes the 
command over the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI 
bus (Port 1). 

Bits 7-15 Resttved: 

These bits are reserved and must be cleared to 0 by the host 


RETURNED VALUES 

Upon command completion, the following information is provided by the Jaguar in the returned lOPB for 
the Issue Bus Device Reset Message command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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ISSUE ABORT MESSAGE (0x4E) 

This message is sent from the initiator to direct a target to clear the present operation. If a 
logical unit has been identified, all pending status f(»' the issuing initiator from the affected 
logical unit is cleared, and the targ^ goes to the Bus Free phase. Pending data and status 
for other initiators is not cleared. If a l<^cai unit has not been identified, the target goes to 
the Bus Free phase. No status or ending message is sent for the operation. 

It is not an error to issue this message to a logical unit that is not currently performing an 
operation for the initiator. This command can be used to terminate an operation that is no 
longer required (killing a Format command to a drive, for example). 

This command must be issued through the Master Command Entry to Work Queue 0. 

The format of the lOPB is as follows: 


word # 


0x0 

Connand Code <0x4E) 

0x1 

Conmand Options 

0x2 

RETURII STATUS 

0x3 

(Reserved) 

0x4 

Normal Completion Vector | Error Completion Vector 

0x5 

Interrupt Level 

0x6 

to 

OxE 

(Reserved) 

OxF 

Unit Address 

0x10 

to 

0x15 

1 (Reserved) 


NOTES: Fields set in bold capital letters are returned values. 
All other values are host provided. Reserved fields 
must be cleared to 0 by the host. 


Figure 119. Issue Abort Message lOPB 


The remainder of this section describes the function of each field in the Issue Abort 
Message lOPB. 


HOST-PROVIDED lOPB FIELDS 

The following information must be provided in the lOPB for the Issue Abort Message command: 


• Command Code (2 bytes) 

This field must be set to 0x4E to execute the Issue Abort Message command. 
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• Command Options (2 bytes) 

This field contains the options for this command. The bits are defined as follows: 

15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

j (Reserved) jlE j 


Figure 120. Command Options for the 
Issue Abort Message Command 


Bit 0 Interrupt Enable (IE): 

Settii^ this bit enables the Jaguar to interrupt the host upon command completion. 
Clearing the bit disables the Command Complete interrupt. 

Bits 1>15 Reserved: 

These bits are reserved and must be cleared to 0 by the hc^. 

• Normal Completion Vector/Error Completion Vector (2 bytes) 

These two bytes specify the VMEbus interrupt vectors that the Jaguar will use to report 
normal command completion and m mman d completion with error. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I NORMAL (»(PLETI0N VECTOR j ERROR COMPLETION VECTOR { 

Figure 121, Normal Completion Vector/Error Completion Vector 
for the Issue Abort Message (Ik)mmand 


Bits 0-7 Error Completion Vecton 

This value specifies the interrupt vector used vdien notifying the host of command 
completion mth errcv. 

Bits 8-15 Normal Completitm Vecton 

This value specifies the interrupt vector used when notifying the host that the command 
completed wUhout error. 

• Interrupt Level (2 l^es) 

This field spedfies the VMEbus interrupt level used to notify the host of a command 
completion (normal or with errcM'). 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

i (Reserved) j LVL { 


Figure 122. Interrupt Level for the 
Issue Abort Message Command 

Bits 0~2 Interrupt Level (LVL): 

These bits set the interrupt level used by the Jaguar to assert a Command Complete 
interrupt on the VMEbus. Values of 0 through 7 are allowed, but a level of 0 is allowed 
only when interrupts are disabled (Interrupt Enable bit = 0 in the Command Options 
word). 

Bits 3>15 Reserved: 

These bits are reserved and must be cleared to 0 by the host. 

• Unit Address (2 bytes) 

This field specifies the SCSI bus and the address of the target device. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

{ (Reserved) jBUSj LUN j SCSI ID { 


Figure 123. Unit Address for the 
Issue Bus Device Reset Message lOPB 

Bits 0-2 SCSI Device ID (SCSI ID): 

These three bits are the SCSI Bus ID (SCSI ID) of the specified device. 

Bits 3*5 Ix^cal Unit Number (LUN): 

These bits describe the SCSI Logical Unit Number (LUN) of the specified device. 

Bit 6 SCSI Bus Selecdou (BUS): 

The SCSI Bus Selection (BUS) bit sele(^ which the two SCSI buses the Jaguar uses 
^en executing the command. When the BUS bit is cleared to 0, the Jaguar executes the 
command over the primary SCSI bus (Port 0). When set to 1, it uses the secondary SCSI 
bus (Port 1). 

Bits 7-15 Reserved: 

These bits are reserved and must be cleared to 0 1^ the host 
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RETURNED VALUES 

Upon command completion, the following information is pro\ided by the Jaguar in the returned lOPB for 
the Issue Abort Message command: 


• Return Status (2 bytes) 

These two bytes hold the returned status of the command. Any non-zero value indicates an 
error code. A list of valid error codes is provided in Appendix C. 
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APPLICATION NOTES 


This chapter contains application notes on the following topics: 

• Error recovery tools 

• Scatter/gather operations 

• Printer port operation 

• Offboard lOPBs 


ERROR RECOVERY TOOLS 

The Jaguar supports a variety of tools for dealing with two basic types of errors that can 
occur — SCSI device errors and controller errors. These error recovery tools are described 
in the following subsections. They are also documented where appropriate in the MACSI 
and lOPB sections of the manual (Chapters 3 and 5). 

SCSI Device Errors 

A SCSI device error is defined to be the completion of a SCSI Command with a status byte 
of any value other than 0x0. Since a de\ice may have many commands queued for it at the 
time an error occurs, SCSI device errors require some m^anism which allows the host to 
alter the order in ^^ch commands are being execnitecL The means provided by the Jaguar 
for this purpose are the Freeze/Thaw Work Queue and Abort Work Queue on Error 
options. 

NOTE: The Freeze/Thaw Work Queue and Abort Work Queue on Error options are 
mutually exclusive. That is, a ^ven work queue canned be both frozen and 
aborted in the event of an error. 

Freeze/Thaw Work Queue and 
Abort Work Queue on Error 


Freeze Work (^eue 

The Freeze Work Queue option provides a mechanism for fireezing the state of a work 
queue when an error exxurs. Error handling can be accomplished by passing one or more 
corrective commands to the device (such as Request Sense or a diagnostic command). Such 
commands must be issued to the device through the Master Command Entry via Work 
Queue 0. After the error handling has been completed, the work queue can be unfrozen. 

The Freeze Work Queue option is enabled on a per queue basis \^dlen the queues are 
initialized. To enable the Freeze option for a queue, set Bit 2 (FZE) in the Work 
Queue Options field of the Tnirialiye Work Queue lOPB. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

|!WQ| RESERVED jPZEj |AEj 


(Word OxF in the Initialize Work Queue lOPB) 

Figure 124. Freeze Work Queue Option 

If enabled, the Freeze bit halts all further commands to a device when any Pass-Back status 
other than “good” (status 0x00) is received from that device. In addition, a bit will be set m 
the Frozen Work Queues Re^er of the Configuration Status Block (see discussion below). 


Commands sent to a “frozen” work queue will not be executed until the work queue is 
“thawed,” as discussed below. Since ^e Freeze Work Queue option is intended to support 
error handling as a part of normal SCSI operations, queues are not frozen for controller 
errors. 

The Freeze Work Queue operation may be optionally changed using the Initialize Controller 
command to freeze a work queue that has an active command upon receiving a SCSI reset. 
The host will “know” a Work Queue is frozen if it receives a command returned from the 
quei^ with a SCSI bus reset error status. It is recommended that you enable this option 
when initializing the Jaguar. The default setting (Le. do not freeze queue if command is 
returned with SCSI bus reset status) is provided for backward compatibility. 

NOTEI: The Freeze Work Queue on Error bit is not enabled for Work Queue 0. This is 
because it is defined to have a length of 1. This is done to ensure that only one 
error recovery proce^ occurs at a time. However, it is possible that a command 
from Work Queue 0 may require error recovery itself. To allow this to take place, 
the SCSI Bus Reset and Flush Work Queue commands may always be issued 
through the Master Command Entry to Work Queue 0. For all other commands 
Work Queue 0 has a length of one. 


Frozen Work Queues Register. IxKated in the Conjuration Status Block, this register 
identifies which work queues are frozen (if any). For Work Queues 1 to 14, if a ^ven 
queue is frozen, then the corresponding bit position is set in the register. As noted before. 
Work Queue 0 cannot be frozen. The format of the register is repeated below for your 
reference: 
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Thaw Work Queue 

After the SCSI error condition has been cleared, the queue can be unfrozen by use of the 
Thaw bit in the MCSB. Execution of commands in the frozen queue is restarted by settii^ 
the least significant bit of the Thaw Work Queue Register. 


The frozen work queue is unfrozen by writing the appropriate work queue number into the 
upper byte of the Thaw Work Queue Regi^er and then setting Bit 0 (THW) of that 
re^er. The Jaguar will clear the register to ackno^edge the thawing of the work queue. 
The Thaw Work Queue Status Register is defined as follows: 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

WORK QUEUE NUMBER { RESERVED |THU j 

(Word 0x4 in the Master Control/Status Block) 

Figure 126. Thaw Work Queue Re^er 


Abort Work Queue on Error 

The Abort Work Queue on Error option causes the Jaguar to abort all commands for that 
work queue until a command is issued with the Abort Acknowledge bit set to 1 in the 
command’s Queue Entry Control Register. This option is mutualfy exclusive with the 
freeze/thaw work queue feature described in the preceding subse^ons. That is, a given 
work queue cannot be both frozen uad aborted in the evexu of an error. 

The register is depicted below: 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

jlWQj RESERVED jPZEj j AEj 


(Word OxF in the Oueue Entry Control Register) 
Figure 127. Abort Work Queue on Error Option 


To enable Abort Work Queue on Error for a given work queue, set Bit 0 of the Work 
Queue Options field when you initialize the work queue. 

When a SCSI Device error occurs, the failing lOFB will be returaed with the bad (non-zero) 
pass-back status. All other commands for that work queue will be returned with a Command 
Complete and Abort Queue set to 1 in the Command Response Word. This will continue 
until a command is found with the Abort Acknowledge bit set to 1 in the command’s Queue 
Entry Control Re^er. This applies not only to the commands in the queue when the abort 
was activated, but to all commzmds issued to that queue imtil the abort is acknowledged. 


Registers for Determining SCSI Bus Status 
and Last Device on Bus 

The Configuration Status Block contains two registers that provide the current SCSI bus 
status. Information in these registers can be used in conjun<^on with the Command Status 
Inquiry and Bus Status Inquiry commands to determine the type of error that has occurred. 

ID of Last Device Connected to SCSI Bus. The Last Device ID bytes contain the SCSI Bus 
IDs of the last devices connected to Port 0 and Port 1. The Bits ^15 contain the Primary 
SCSI Bus ID last connected. The Bits 0-7 contain the Secondary Bus ID last connected. 

SCSI Bus Status. The SCSI Bus Status field describes the status of the primary and 
secondary SCSI buses. Bits 8-15 contain the primary bus status. Bits 0-7 contain the status of 
the secondary bus (if used). Both bytes are images of the Fujitsu 87030 phase sense register. 
The format of that regi^er is as follows: 

07 06 05 04 03 02 01 00 

i REQ I kCK I ATM | SEL | BSY { MSG | C/D i I/O | 


Figure 128. SCSI Bus Status Byte 

Each of the above signals is active high and corresponds to a specific SCSI bus signal. 

The signals of most importance are BSY and SEL. When BSY is a "1’, the Jaguar is 
connected to the SCSI bus. When SEL is a *1’, it indicates that someone on the bus is 
attempting to select or reselect anc^er de^ice. For a complete description of the signals, 
please refer to the SCSI specification or the Fujitsu 87030 phase sense register user’s guide. 

The SCSI Bus Status bytes arc updated every 27 to 35msec If the host is attempting to use 
this register to determine if the bus is hung, it should allow at least twice that period before 
making a dedsion. The actual amount of time required is dependent on the system. In 
general, it should be longer than the longest data transfer that might occur in the system. 
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Error Recovery Commands 

Normal SCSI check condition errors are handled very simply via SCSI protocol. However, 
there are other types of errors from which it can be difficult to recover, such as errors due 
to a bad device or bug in the device driver program. 

The Jaguar provides three commands that can be used to determine what type of error has 
occurred without having to reset the board. They are: 

• The Command Status Inquiry lOPB reports the status of a command, identified by its 
command tag. 

• The Bus Status Inquiry lOPB reports the state of all lOPBs requesting the SCSI Bus. It 
is used to find the command that is active on the bus at the time an lOPB timeout 
(discussed below) has occurred. This is important because a command may cause 
another command to time out by blocking use of the SCSI bus by other devices. 

• Cancel Command Tag removes an lOPB from the board. This command is provided for 
systems that can reset devices in error without resetting the SCSI bus. 

The above commands must be issued through the Master Command Entry to Work Queue 
0. They may be issued at any time. 

For additional information on the above three commands, refer to the descriptions of the 
individual commands in Chapter 5. 

Selection and Command Timeouts 

The Jaguar provides two features to signal unusual errors —selection timeout and command 
timeout. Selection timeouts prevents the board from becoming locked up by trying to select 
a device that does not exist Command timeouts let the Jaguar notify the host that a user- 
programmed period of time has expired since a device was successfully selected. 


Selection Timeout 

The selection timeout causes an lOPB to be terminated with an error status if a device does 
not respond to selection within the programmed period of time. The same value is used for 
all devices. This value is specified in the Controller Initialization Block. This timeout has a 
resolution of 1msec 


Command Timeout 

The command timeout is specified in the Initialize Controller command for Work Queue 0, 
and in the Initialize Work Queue command for all other queues. All lOPBs issued through 
a work queue will use the timeout value specified for that work queue. 

— For Work Queue 0, the ninth word of the Controller Initialization Block is used for 
Work Queue 0 command timeouts. This field (word 9) is specified in increments of 
256 msec A value of 0 specifies no timeout 

— The timeout values used for commands issued thro ugh Work Queues 1-15 are set when 
the queues are initialized. The twelfth word of the Tnitialize Work Queue command 
contains the timeout value, which is specified in increments of approximately 256msec 
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Thus, each work queue (device) is able to run a unique timeout value. A value of 0 specifies 
no timeout. 

To determine whether or not a command has timed out, the Jaguar measures how much time 
has elapsed between the successful completion of the selection phase to the completion of the 
command on the SCSI bus (including all disconnect periods). 

When a command timeout occurs, the Jaguar uses the Controller Error Interrupt and Vector 
to inform the host of the condition (see discussion in next subsection). This mechanism returns 
an error status without returning the lOPB that caused the error. Command timeouts mvoke 
a Controller Error Vector Status Block with Error Code OxCl (lOPB Timeout) in the Error 
Code field. If the command subsequently completes correctly, the original lOPB will complete 
properly. The host may attempt to cancel the lOPB with the Cancel Command Tag lOPB. This 
will cause the Jaguar to terminate any further execution. The cancelled lOPB will not be posted 
back to the host. If the lOPB is active on the SCSI bus, the command cannot be cancelled and 
the host must either reset the SCSI bus or remove the device from the bus in some external 
manner. The command will then be posted with a Canceled Due to Bus Reset Status or Invalid 
Sequence error if it abruptly disconnects from the bus. 

The Jaguar must retain the lOPB which caused the timeout until the error condition has been 
cleared. This is necessary for two reasons. Flr^ it allows the command to be completed if the 
device responds before error recovery can take place. Second, it prevents new commands from 
being issued from the queue until the host can handle the error condition. 

The usual technique for clearing errors to issue a Reset SCSI Bus lOPB. This causes all of 
the commands currently active on that bus to be returned with a bus reset status. However, if 
your system is capable of removing individual devices from the bus, you have an alternative to 
resetting the entire bus. The alternative is to remove the device in error and then issue a Cancel 
Command Tag lOPB to dear the lOPB which is waiting for a response from the removed 
device. 

If a command other than the command that timed out is active on the bus, it will be necessary 
to determine which command actually caused the error. There are a number of methods for 
determining the device in error. One technique is to have the host wait an additional period of 
time and check the board again to see that the state is the same as the previous check. This type 
of error is due either to incorrect programming or to a failed device and should be a rare 
occurrence. 


Controller Error Interrupt and Vector 

Controller errors are generated v^en an error occurs on the Jaguar that is not related to a 
spedfic lOPB. This can be due to a variety of unusual board-related conditions. They may 
also be generated if the host issues an lOPB tlu^ lacks the proper information needed for the 
command to be processed normally. 

The interrupt level and vector used to signal such errors are set in the Controller Error 
Completion Level/Vector field of the Controller Initialization Block (sec page 70). 

Controller errors will not generate an intermpt if the controller error interrupt level is deared 
to 0 in the Initialize Controller lOPB. However, the board will report controllers errors to 
the Command Response Block even if interrupts are not enabled. 


128 




6 Application Notes 


The J<^uar flags a controller error by setting the following bits in the Command Response 
Status Word: bit 7 (Status Change), bit 2 (Error), and bit 0 (Command Response Block 
Valid). Thus, the Command Response Status Word will read 0x0085 to signal the error. 

The Controller Error Vector enables the host to determine the source of a variety of errors. 
These include: 

— errors associated vdth three bit-type commands (Start Queue Mode, Flush Work Queue, 
and Flush Queue and Report) 

•— lOPB type error 

— lOPB timeout 

— a device has connected for which no lOPB exists 

— a device is requesting more data to be transferred than the lOPB allows 

a device is requesting a data transfer of the opposite direction specified by the direction 
bit of the lOPB 

The Jaguar flags a controller error by setting the following bits in the Command Response 
Status Word: bit 7 (Status Change), bit 2 (Error), and bit 0 (Command Response Block 
Valid). Thus, the Command Response Status Word will read 0x0085 to sign^ the error. 

With the exception of the bit commands (Start Queue Mode, Flush Work Queue, and Flush 
Queue and Report), the above-listed error conditions cause the Jaguar to return a 
Controller Error Vector Status Block to the Command Response Block. This returned 
structure does not contain an lOPB. Instead, it contains an error code indicating what has 
happened, along with information from the Command Queue Entry that was being executed 
when the error occurred (command tag, lOPB length, and work queue number). 


word # 


0x0 


CQHMANO 

RESPONSE STATUS WORD 

0x1 


lOPB TYPE 

j RESERVED 

0x2 



COMMAND TAG 

0x3 




0x4 


lOPB LENGTH 

1 WORK QUEUE NUMBER 

0x5 

RESERVED 

0x6 


RESERVED 

{ ERROR CODE 


Figure 129. Controller Error Vector Status Block 
Controller Error Codes 

The valid error codes which may be returned in word 6 of the above block are as follows: 
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Table 23. Returned Error Codes for Controller Error Vector 


CODE 

OEFIMITIGM 

OxCO 

lOPB type error 

0xCl 

lOPB Timeout 

0x82 

A target has reconnected for which no lOPB exists. 

0x83 

A target is requesting more data to be transferred 
than the lOPB transfer count allows. 

0x84 

A target is requesting a data transfer of the opposite 
direction specified in the direction bit of the lOPB 


IQPB Type Error (QxCO). If the lOPB type field is invalid the overall structure of the lOPB 
is not known and therefore continued processing on it can not be executed. This error code 
indicates that the Command Queue entry contains invalid information. 

lOPB Timeout Error fOxCl). An lOPB has timed out. The lOPB will remain active until it 
completes properly or is cancelled explicitly. The status of the lOPB may be inquired about 
with the Command Status Inquiry lOPB. Mth this error code. Command Queue entry 
information is valid. 

Unknown Device Reconnection (0x821. A SCSI device for wiiich no current IQPB exists has 
re-selected the Jaguar. This code indicates that the Command Queue entry contains invalid 
information. 

Data Transfer Count Mismatch (0x83>. Data counters have been exhausted, but the device 
is requesting more data than the current lOPB can transfer. With error code, the 
Command Queue entry information is valid. 

Data Direction Errors (0x84). The direction bit in the IQPB does not match the data 
transfer direction requested on the SCSI bus. This error code indicates that the Command 
Queue entry information is valid. 


Suggested Error Recovery Sequence 

The following is a suggested series of steps which may be taken by the host to recover from 

an erron 

1. The host issues a Bus Status Inquiry to examine the status of commands executing on the 
bus. This enables the host to determine ^i^ch command caused the error. Note that the 
command ^ch timed out may not be one that is actually blocking the SCSI bus. The 
command that is most likely in error will be the one active on the bus when the Bus 
Status Inquiry is executed. 

2. If a device is found to be connected on the SCSI bus indefinitely, there is no way to clear 
the error without resetting the bus. When this is the case, the host should issue the Reset 
SCSI Bus IQPB through the Master Command Entry. AH work queues with commands 
active on the bus will have those commands returned with a SCSI Reset Error status, 
md the work queue will be frozen (if the Freeze Work Queue on Reset option was 
selected in the Initialize Controller Command). 
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3- The device which caused the error should either be removed or tested before restarting 
normal operation. The host can then reissue the commands and unfreeze the work 
queues. 

4. For systems that have the ability to power down individual devices, the Flush Work 
Queue command can be used to prevent new commands from being issued to the device 
after the error has been cleared. It is not mandatory to flush the work queue before 
restoring the device, but be aware that the Jaguar \^ill begin processing the commands 
from the queue as soon as: 1) the bus becomes available, and 2) the command that was 
being executed is cleared. 

After powering down the device, the host should issue a Cancel Command Tag lOPB to 
clear Ae command which caused the error (Le. the lOPB that was not completed by 
either a normal SCSI completion or by a SCSI reset). 

NOTE: The Flush Work Queue Command does not flush commands that are presently 
active on the bus. These may only be canceled by: 1) a normal command 
completion, 2) a SCSI reset, or 3) a Cancel Command Tag lOPB. 


SCATTER/GATHER OPERATIONS 

The scatter/gather option allows contiguous peripheral data in system memory to be written 
to non-contiguous areas (“scatter”), or moved from non>contiguous blocks of memory into 
contiguous ones (“gather”). Scatter/gather operations can only be performed with SCSI 
peripheral data. They cannot be used in conjunction with the printer port. 

By allowing multiple blocks of data to be transferred using only one command, 
scatter/gather frees the host from having to process multiple transactions when transferring 
non-contiguous blocks. This improves system performance by minimizing both the number 
of VMEbus interrupts and the number of bus transactions associated mth common 
peripheral activity. 

To enable scatter/gather, set bit 1 of the Command Options word in the SCSI Pass-Through 
lOPB. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

I RESERVED IS/GilE} 


(Word 0x1 in the SCSI Past-Through lOPB) 

Figure 130. Command Options Word in the SCSI Pass-Through lOPB 


With scatter/gather enabled, the foUovring three lOPB fields reference the Scatter/Gather 
Element list 1) Memory T^/Transfer Type/Address Modifier, 2) Buffer Address, and 3) 
Transfer Length. The Memory Type/Transfer Type/Address Modifier field has the same 
definition as it does for lOPBs which do not perform scatter/gather operations, except for 
the Link bit (Bit 15). For an explanation of this bit, sec “Scattcr/Gather List Li nkin g"*, 
below. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

iLNKj RSRV I TT j MT { ADDRESS MODIFIER 


(Word 0x7 in the SCSI Pass-Through lOPB) 

Figure 131. Memory Typc/Transfcr Type/Address Modifier Field 
for Scatter/Gather Operations 


When scatter/gather is used, words 0^ - 0x9 of the !OPB cx)ntain the address of the 
scatter/gather list. If the Memory Type is 0x1 or 0x2, the value is interpreted as an address 
in system memory. 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


SCATTER/GATHER LIST ADDRESS (4 Bytes) 

i I 

(Words 0x8 - 0x9 in the SCSI Pass-Through lOPB) 

Figure 132. Scatter/Gather List Address 

Words OxA - OxB contain the number of elements in the scatter/gather list. Valid entries in 
this field are 1 to 64 (decimal). 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 



RESERVED 

RESERVED 

1 S/G ELEMENT COUNT 


(Words OxA - OxB in the SCSI Pass-Through lOPB) 

Figure 133. Scatter/Gather Element Count 

Words OxC - OxD of the lOPB spedfy the sum of the individual element entry counts. 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


TOTAL TRANSFER LENGTH (4 BYTES) 

I I 

(Words OxC - 0x0 of the S(^I Pass-Throuj^ lOPB) 

Figure 134. Total Transfer Length for Scatter/Gather Operations 

NOTE: If the Total Transfer Length field is ‘O’, the Jaguar will calculate this value 

internally. This feature is provided for compatibility with eariy firmware revisions. 
All new applications should provide a spedfic value in this field. 
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Scatter/Gather List 

The scatter/gather option uses a list of elements to control the scatter/gather operation. 
Each element in the list specifies the byte count, address, memory type, and address 
modifier for each block of data in system memory that is to be transferred by one SCSI 
Pass-Through command. Each element in the list is an 8-byte entry. The format is as 
follows: 

word # 

0 
1 
2 
3 


word # 
n*4 

(n*4)+1 
(n*4)+2 
Cn*4)+3 

Figure 135. Scatter/Gather Element List Format 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 




ELEMENT 

1 BYTE COUNT 

(2 BYTES) 




ELEMENT 

1 BUFFER ADDRESS 

(4 BYTES) 

... 

LNK| 

RSRV 

' TT 

1 '' 

MT } ADDRESS MODIFIER 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 



ELEMENT N BYTE COUNT (2 BYTES) 


... 

ELEMENT N BUFFER ADDRESS (4 BYTES) 

... 

LNKj 

RSRV 1 TT 1 MT 1 ADDRESS MODIFIER 



This scatter/gather list can have from 1 to 64 elements. Using scatter/gather for lists with 
just one element, however, would be ineffident. 

Scatter/Gather list Linking 

To facilitate larger scatter/gather lists, any element in the scatter/gather list may contain a 
LINK bit. When LINK (bit 15) is set, the element structure will contain information that 
points to the next group of scatter/gather ebments. An element that forms a link should 
have the following structure: 


word # 

0x0 
0x1 
0x2 
0x3 

LMK « 1 

Figure 136. Link Element Structure 


RESERVED | S/G COUNT 


SCATTER/GATHER LIST ADDRESS 


LNKj I TT { MT { ADDRESS NOOIFIER 
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The scatter/gather count field contains the number of elements in the next link to be 
gathered by the Jaguar. Valid Counts are 1 to 64. 

If scatter/gather list linking is used, all lists mu^ be built at the time the lOPB is issued. 
In addition, the Total Trailer Count field in the lOPB must be contain the sum of all 
individual data element counts. (It should not contain the link element counts.) 


PRINTER PORT OPERATION 

The J 2 ^;uar’s printer port allows the host to transfer data to either a Centronics or 
Dataproducts short line interface printer. A version is also available for use with a 
Dataproducts longline interface. 

The printer port is a daughter card that attaches to the Jaguar. To execute a print 
command, the host issues an lOPB to Port 1 in much the same fashion as it would to a 
SCSI device. With the printer port installed. Port 1 is dedicated to the printer and cannot be 
used for SCSI transactions. 


When sending data to the printer, the Jaguar DMAs the printer data firom host memory, 
transfers it to the printer via Port 1, and then returns a completion status. Printer status may 
be monitored asynchronously at any time by the host. The host may also request that the 
Jaguar interrupt the host >^en a status change occurs. The printer port does not affect the 
normal operation of the primary SCSI port (Port 0). 


Verifying Printer Port Installation 


Once the host has initialized the Jaguar, it can verify that the printer port is installed by 
checking the Daughter Card ID field in Configuration Status Block. The printer port 

lU&ULUlVaUUU ^UALTt^ dUUUiU lU Ulld Ll^lKU 


Initializing the Port 

The printer port requires a separate work queue. It will therefore be necessary to create a 
work queue for it using the Initialize Work Queue command, just as you would for a SCSI 
device. This work queue must be used exclusively used for the printer port. 

The first command to the printer work queue should be the Initialize Printer Port 
command. This command sets a variety of parameters, including: 1) the polarity of parity for 
Dataproducts printers, and 2) ^^ch printer status lines may generate a status ^ange 
interrupt. 

The Initialize Printer Port command can be issued at any time to reset the printer port. The 
command is issued vnth the reset bit set to clear the printer port hardware. It should never 
be necessary to reset the hardware. The command may also be issued at any time to assert a 
buffer clear to the printer. Since the time required for holding this signal varies fi‘om printer 
to printer, the Jaguar will leave the line set until the host issues another Initialize Printer 
Port command with the bit cleared. 


Issuing Printer Commands 

The Jaguar will queue Printer Port lOPBs as received and work on each command in a 
FIFO manner as the previous command completes. When the Go/Busy bit for a printer 
command is set, the command win be copied firom short I/O space into the internal printer 
port work queue. After the lOPB has bwn parsed for correctness, the data will be 
simultaneously DMA’d fi'om system memory and transferred to the host. When all the data 
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has been transferred to the printer, a copy of the lOPB modified with the current printer status 
and return code will be placed in the Command Response Block. 


HOST 

Initialize Controller lOPB 
Initialize Work Queue lOPB(s) 
Initialize Work Queue lOPB(s) 
Printer Port lOPB(s) 


JAGUAR 


Connand Complete 


Command(s) Complete 


Command Complete 


•* - Command(s> Complete 


Figure 14. Example of Printer Port Operation 

If the printer port is configured for the Dataproducts interface, the host may want to send 
special font or control characters to the printer using the Paper Instruction control line of the 
Dataproducts interface. The Jaguar supports this with the Paper Instruction option in the lOPB. 
When the Paper Instruction option is set to 1, the Jaguar will transfer all of the data specified 
in this lOPB to the printer with the Paper Instruction interface signal active. Paper Instruction 
is only supported by Dataproducts printers. 


Status Reporting 

The printer status may be accessed in three ways fi-om the Jaguar: 

1) The state of the status lines is updated periodically in Configuration Status Block for 
asynchronous monitoring by the host. This status is stored in the Secondary Phase 
Sense/Printer Status field of the Configuration Status Block. For a Dataproducts interface, 
this byte is updated whenever Online, Ready, Parity Error, or Cable On changes state. For 
a Centronics interface, it is updated anytime Sele^ Fault, or Paper Empty changes state. 
For all interfaces, it is also updated approximately every 30 msec, as well as at the 
completion of a print command. 

2) The second method is for the Jaguar to use the Controller Normal Interrupt Vector specified 
in word 0x2 of the Controller Initialization Block. The host may select which status Imes can 
generate an interrupt in the Initialize Printer Port lOPB. An interrupt is generated when 
an enabled status line (except parity) toggles either active or inactive. Parity error is only 
reported vriien it becomes active. The complete status word will be updated in Configuration 
Status Block, and a Command Response Block will be posted. 

3) The third method for accessing printer information is to issue a Printer Port lOPB with 
both the Maximum Transfer Len^ and the Printer Transfer Length fields set to zero. 
This causes the printer port to update the Printer Status field of the lOPB and immediately 
return it as command completed 


OFFBOARD lOPBs 


The Jaguar’s MACSI int erface is optimum for systems that have quick host access to 
the VME short I/O space. In some systems, however, reading and writing data to/from this 
space can be quite time consuming. To speed up I/O in such systems, the Jaguar supports a 
technique that enables the host to control the Jaguar with just two reads and two writes into 
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the Jaguar’s short I/O space for each command This technique mvolves building offboard 
Command Queue entries, lOPBs, and an oSboard Command Response Block. 

NOTE: In order execute offboard lOPBs, the Jaguar must be able to access the host 
memory using its DMA facility. 


Overview 


In order to implement oSboard lOPBs, you will need to allocate one or more blocks of 
system memory for sole use by these structures. The Jaguar’s onboard Command Queue 
entries can then initialized to point to these fixed areas of memory. These pointers should 
not be changed once normal board operation has begun. 

The host builds ofiboard lOPBs and Command Queue entries in this space. The only time it 
accesses the Jaguar’s onboard Command Queue entry is to set the Go/Busy bit. 

The Jaguar then DMAs the oBboard 0}mmand Queue entry/IOPB onboard and executes 
the command. Upon completion of this command fetch, the Jaguar clears the Go/Busy bit 
in the onboard Command Queue entry. 

Building Offboard lOPBs 

To build an offboard lOPB, set the Fetch Offboard Bit (FOB) in the Queue Entry Control 
Renter. This is the first word of the onboard Command Queue entry. Setting this bit 
changes the purpose of the fields within the Command Queue entry, but it does not change 
the size of the Command Queue entry. 

When the FOB bit is set, the Jaguar interprets the address in the onboard Command Queue 
entry as a pointer to a block of offboard memory consisting of an external Command Queue 
and one or Command Queue entries. 

Offboard Command Queue entries and lOPBs have the same structure as their onboard 
counterparts, except that the lOPB Address field in an offboard Command Queue entry has 
no meaning. 

The format of an offboard Command Queue entry is shown below: 


word # 


0x0 

QUEUE ENTRY CONTROL REGISTER 

0x1 

RSRV 

i TT 1 NT 1 ADDRESS MODIFIER 

0x2 


HOST MEMORY ADDRESS 

0x3 



0x4 

lOPB LENGTH | RESERVED 

0x5 

RESERVED 


Figure 138. Format of Offboard Command Queue Entry 

Note the following important restrictions when building offboard Command Queue 
entries/IOPBs: 

1) Each offboard Command Queue entry must be contiguous with its corresponding 

offboard lOPB in system memory (with the Command Queue entry residing in the lower 
portion of the block of memory). 
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2) Because a single DMA operation of the Jaguar cannot cross nonadjacent page 

boundaries, an oSboard Command Queue entry and its correspond^ lOPB cannot be 
spread across two nonadjacent pages in physical memory. 

The host may mix onboard and offboard commands by setting (or clearing) the FOB Bit in 
the Queue ^try Command Re^er of individual commands. However, this is not 
recommended for normal operation. It may be useful for handling errors or when operating 
the Jaguar in a standalone fashion. 


Initiating Oftboard commands 

To initiate a command, the host: 1) reads the Go/Busy bit of the next Command Queue 
entry to ensure that the entry is avklable, and 2) sets that same Go/Busy bit after it has 
assembled the oftboard Command Queue entry and lOPB. 

If there is no external memory at the location spedfied in the Command Queue entry, the 
Jaguar will get a VME bus error (BERR*) when it tries to read the offboard Command 
Queue entry/IOPB. In this event, the Jaguar uses the default Error Level/Vector in the 
Controller Initialization Block and pla<^ the Command Queue entry/IOPB at the normal 
Command Response Block (CRB) location in short I/O. 

Offboard Command Response Block 

In order for the Jaguar to write a returned lOPB offboard, you need to designate a block of 
system memory for use as an offboard Command Response Block. Then, write a pointer to 
the block in the Controller Initialization Block, and execute the Initialize Controller 
command. Any non-zero value in the poiiUer field instructs the Jaguar to write returned 
lOPBs to the offboard address. 

Refer to the sections on the Command Response Block (p. 35) and Controller Initialization 
Block (p. 70) for additional information. 

Once you have initialized the Jaguar to write command responses to an offboard Command 
Response Block, all responses will be written to this structure unless a bus error occurs 
during the write operation. 

Posting Command Completion 

If the pointer to the external Command Response Block in the Controller Initialization 
Block is zero, then the Jaguar posts command response information in the Command 
Response Block secdcm of its own short I/O space. 

Once it complies a command, the Jaguar DMAs the command response information into 
external memmy and then generates a Command Complete Interrupt 

Before reading the command response informatimi in its own memory, the host should first 
read error status in the Jaguar’s onboard Command Response Block. (This information is 
inaccessible once the Jaguar’s CRBV bit is cleared.) If an error occurs, the location of the 
Command Response Block will depend on the type of error. If the error is a SCSI device 
error, the Command Response Block/retumed lOPB will be written offboard to the address 
spedfied in the Controller Initializatioo Block. 

On the other hand, if the error status diows that a bus error (BERR*) occurred when 
attempting to move the information into the offboard Command Response Block, then the 
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host can find the Command Response Block and lOPB in short I/O at the address specified 
in Word 6 of the Controller Initialization Block (Command Response Block offset). 

After checking the error status, the host can respond to the interrupt by clearing the CRBV 
bit (Command Response Block Valid) in the Command Response Status Word of the 
Jaguar’s onboard Command Response Block. 
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APPENDIX A 


SPECIFICATIONS 

VMEbus SPECIFICATIONS 


DTB Master 

A24, A32, D16, D32 

DTB Slave 

A16, D8, D16 

Requester 

Any of R(0-3), Static 

Interrupter 

Any <rf 1(1-7), Dynamic 

SCSI BUS SPECIFICATION 


Periphercd Data Rate 

Up to 4Mbytes/sec synchronous 

Up to 13Mbytes/sec asynchronous 

POWER REQUIREMENTS (Single-ended drivers) 

V/SCSI 4210 Jaguar 

4,67 A typical @ +5V DC (+/- 5%) 

6.85 A ffiaximmn @ + 5V DC ( + /- 5%) 

V/SCSI 4210-DC Option SCSI port 

0.75 A typical @ +5V DC (+/- 5%) 

1,25 A maximum @ +5V DC (+/- 5%) 

MECHANICAL (nominal) 


Length 

233 mm 

Width 

160 mm 

Thickness 

20 mm 

Weight 

.45 Kg 

OPERATING ENVIRONMENT 


Temperature 

0-55 degrees Centigrade 

Relative Humidity 

10% - 90% Noncondensing 

FUSE: 


The Jaguar has one fuse (FI) used to protect the SCSI terminator power when provided by the Jaguar. Its 
part number is Littlefuse PN 251001, To determine the location of the fuse on the board, refer to the 

appropriate board layout (p. 8 or 9). 
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DIAGNOSTIC LEDs 

The Jaguar has four LEDs behind the panel that may provide useful diagnostic information. To locate the 
LEDs, refer to either Jaguar board layout (page 8 or 9). The placement and use of the LEDs are identical 
for both board layouts. 

LED: Ehtplanatioo: 

0 VMEbus Busy (System) — This LED is active when the 

VMEbus BBSY* signal is active. 

1 VMEbus Busy (Jaguar) — This LED is active when the 

Jaguar is dri\ing BBSY*. 

2 SCSI Busy (Port 0)—This LED is active when Port O’s 

SCSI BSY* signal is active. 

3 This LED is not used. 


RELIABILITY 

MTBF per MIL STD 217E 68,400 hours 
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APPENDIX B 

CONNECTOR PINOUTS AND CABLING 


OVERVIEW 

This appendix contains the connector pinouts and cabling information needed for various 
Jaguar configurations. The tables in this appendix are listed belcwi 


• Table B-1. 

• Table B-2. 

• Table B-3. 

• Table B-4, 

• Table B-5. 

• Table B-6. 


Single-ended SCSI port pinouts (p. 143) 

Differential SCSI port pinouts (p. 144) 

Dataproducts Short Line printer cable pinouts (p. 145) 
Dataproducts Long Line printer cable pinouts (p. 145) 
Centronics printer cable pinouts (p. 146) 

PI connector (p. 147) 
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DESCRIPTION OF SCSI CABLE 


All possible SCSI bus configurations on the Jaguar (single-ended vs. differential, and routed 
off P2, P3, or P4) require the same standard SCSI cable. A standard SCSI cable is either a 
50-conductor flat cable or a 25-signal twisted-pair cable. The cable is one-to-one, with 50- 
pin connectors on both ends. As per SCSI specifications, the cable can be up to 20 feet long 
(6 meters) for a single-ended SCSI bus and ^ feet long (25 meters) for a differential one. 

Below is a list of sample part numbers which you may find to be useful in cabling your 
system. Interphase assumes no responsibility regarding the functionality of the parts listed 
below. If you need more information concerning the parts, contact the manufacturer 
directly. 


Component 
Flat Cable 
Connectors 

• End of cable connector 

- Without strain relief; no center key 

- With strain relief; no center key 

- Without strain relief; with center key 

• Daisy Chain 

- Mthout rtrain relief; no center key 

- With strain relief no center key 

- ^^^thom strain relief; with center key 


Sample part no. 
3M-3365-50 


3M-3425-7000 
3M-3425-7050 
Dupont 66900-290 

3M-3425-6000 
3M-3425-6050 
Dupont 66900-250 
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SINGLE-ENDED SCSI CABLE PINOUT 

The following pinout applies to all Jaguar connectors which provide a single-ended SCSI 
port, whether the port is routed off P2, P3, or P4. 


Table B-1, Single-Ended SCSI Port Pinouts 


Pin 

Nnewiic 

Pin 

Mneannic 

1 

GNO 

2 

o 

CD 

O 

3 

GNO 

4 

OBI- 

5 

GNO 

6 

DB2- 

7 

GNO 

8 

0B3- 

9 

GNO 

10 

o 

5 

11 

GNO 

12 

DB5- 

13 

GNO 

14 

0B6- 

15 

GNO 

16 

0B7- 

17 

GNO 

18 

OBP- 

19 

GNO 

20 

GNO 

21 

GNO 

22 

GNO 

23 

GNO 

24 

GNO 

25 


26 

TERHPWR 

27 

GNO 

28 

GNO 

29 

GNO 

30 

GNO 

31 

GNO 

32 

ATN- 

33 

GNO 

34 

GNO 

35 

GNO 

36 

BSY- 

37 

GNO 

38 

ACK- 

39 

GNO 

40 

RST- 

41 

GNO 

42 

HSG- 

43 

GNO 

44 

SEL- 

45 

GNO 

46 

C/O- 

47 

GNO 

48 

o 

Ul 

49 

GNO 

50 

I/O- 


NOTE: If no signal is referenced, then the Jaguar does 
not use that pin. 
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DIFFERENTIAL SCSI CABLE PINOUT 

The following pinout applies to all Jaguar connectors which provide a differential SCSI port, 
whether the port is routed off P2, P3, or P4. 


Table B-2. Differential SCSI Port Pinouts 


Pin 

ItioKnic 

Pin 

Nneaonic 

1 

SHIELD 

2 

GNO 

3 

r\D#Vi. 

4/WV^ 

/ 

080- 

5 

D81+ 

6 

081- 

7 

D82+ 

8 

082- 

9 

083+ 

10 

083- 

11 

D84+ 

12 

084- 

13 

085+ 

14 

085- 

15 

086+ 

16 

086- 

17 

087+ 

18 

087- 

19 

D8P+ 

20 

08P- 

21 

OIFFSENS 

22 

GNO 

23 

GNO 

24 

GNO 

25 

TERMPUR 

26 

TERMPWR 

27 

GnD 

23 

GNO 

29 

ATN+ 

30 

ATN- 

31 

GNO 

32 

GNO 

33 

8SY+ 

34 

8SY- 

35 

ACK+ 

36 

ACK- 

37 

RST+ 

38 

RST- 

39 

HSG+ 

40 

MSG- 

41 

SEL+ 

42 

SEL- 

43 

C/0+ 

44 

C/D- 

45 

REQ+ 

46 

REQ- 

47 

10+ 

48 

10- 

49 

GNO 

50 

GNO 
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DATAPRODUCTS PRINTER CABLING 


Table B-3. Cable Pinouts for P4 Connector to Dataproducts Short Line Printer 


4210 P4 

Dataproducts 
(Short Line) 

Functions 

4210 P4 

Dataproducts 
(Short Line) 

Function 

6 

19 

DATA 1 

11 

37 

RETURN 

7 

3 

RETURN 

42 

31 

BUFFER CLEAR 

9 

20 

DATA 2 

43 

15 

RETURN 

10 

4 

RETURN 

34 

12 

+5V (NOT SUPPLIED) 

1 

4 

1 

nAT« X 

1 rt ^ 

15 

22 

READY 

4 

2 

RETURN 

16 

6 

RETURN 

23 

41 

DATA 4 

12 

21 

ON LINE 

20 

40 

RETURN 

13 

5 

RETURN 

2 

34 

DATA 5 

18 

23 

DEMAND 

3 

18 

RETURN 

19 


RETURN 

29 

43 

DATA 6 

30 


PARITY ERROR 

26 

42 

RETURN 

31 


RETURN 

8 

36 

DATA 7 

24 


BOTTOM OF FORM 

5 

35 

RETURN 

25 


RETURN 

33 

28 

DATA 8 

27 


PAPER MOVING 

32 

44 

RETURN 

28 


RETURN 

36 

29 

DATA PARITY 

17 


GROUND 

37 

13 

RETURN 

21 


TOP OF FORM 

39 

30 

PAPER INSTRUCTION 

22 


RETURN 

40 

14 

RETURN 

38 


INTERFACE CONNECTED 

14 

38 

DATA STROBE 

35 

WHM 

INTERFACE CONNECTED RETURN 


NOTE: If no signal is referenced, then that pin is not used. 


Table B-4. Cable Pinouts for P4 Connector to Dataproducts Long Line Printer 


4210 P4 

Dataproducts 
(Long Line) 

Functions 

4210 P4 

Dataproducts 
(Long Line) 

Function 

6 

19 

DATA 1+ 

11 

37 

DATA STROBE- 

7 

3 

DATA 1- 

42 

31 

BUFFER CLEAR* 

9 

20 

DATA 2+ 

43 

15 

BUFFER CLEAR- 

10 

4 

DATA 2- 

34 

12 

*5V (NOT SUPPLIED) 

1 

1 

DATA 3+ 

15 

22 

READY* 

4 

2 

DATA 3- 

16 

6 

READY- 

23 

41 

DATA 4+ 

12 

21 

ON LINE* 

20 

40 

DATA 4- 

13 

5 

ON LINE- 

2 

34 

DATA 5+ 

18 

23 

DEMAND* 

3 

18 

DATA 5- 

19 


DEMAIfl)- 

29 

43 

DATA &*■ 

30 


PARITY ERROR* 

26 

42 

DATA 6 - 

31 


PARITY ERROR- 

8 

36 

DATA 7+ 

24 


BOTTOM OF FORM* 

5 

35 

DATA 7- 

25 


BOTTOM OF FORM- 

33 

28 

DATA 84- 

27 


PAPER MOVING* 

32 

a 

DATA 8 - 

28 


PAPER MOVING- 

36 

29 

DATA PARITY* 

17 


GROUND 

37 

13 

DATA PARITY- 

21 


TOP OF FORM* 

39 

30 

PAPER INSTRUCTION* 

22 


TOP OF FORM- 


14 

PAPER INSTRUCTION- 

38 


INTERFACE CONNECTED 


38 

DATA STROBE* 

35 

mM 

INTERFACE CONNECTED RETURN 


NOTE; If no signal is referenced, then that pin is not used. 
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Dataproducts Cable Description 


Both short and long line Dataproducts printer configurations require a 50-conductor flat 
ribbon cable. Below is a list of sample part numbers vvdiich you may find to be useful in 
cabling your system. Interphase assumes no responsibility r^rding the functionality of 
the parts listed below. If you need more information concerning the parts, contact the part 
manufacturer directly. 


Component 


Sample part no. 


Flat Cable 


3M-3365-50 


Connectors 

• Jaguar end 

— Without strain relief; no center key 
— With strain reliel^ no center key 
— Without strain relief; with center key 

• Dataproducts end 


3M-3425-70(X) 
3M-3425-7050 
Dupont 66900-290 
T&B Ansley 609-50P* 


* The connector type needed for your specific Dataproducts printer may be diUerent from that given above. Be 
sure to verify your printer’s connector requirements before making the cable. 


CENTRONICS PRINTER CABLING 


Table B-5. Cable Pinouts for P4 Connector to Centronics Printer 


4210 P4 

Centronics 

Function 

4210 P4 

Centronics 

Function 

mm 

2 

DATA 1 

11 

19 

RETURN 


20 

RETURN 

42 

31 

PRINTER INITIALIZE 


3 

DATA 2 

43 

30 

RETURN 


21 

RETURN 

34 

NU 

NOT USED 

1 

4 

DATA 3 

15 

32 

FAULT 

4 

22 

RETURN 

16 

NU 

NOT USED 

23 

5 

DATA 4 

12 

13 

SELECT 

20 

23 

RETURN 

13 

NU 

NOT USED 

2 

6 

DATA 5 

18 

10 

ACKNOWLEDGE 

3 

24 

RETURN 

19 

28 

RETURN 

29 


DATA 6 

30 

12 

PAPER ENTRY 

26 


RETURN 

31 

NU 

NOT USED 

8 


DATA 7 

24 

NU 

NOT USED 

5 


RETURN 

25 

NU 

NOT USED 

33 


DATA 8 

27 

11 

BUSY 

32 


RETURN 

28 


RETURN 

36 


NOT USED 

17 


NOT USED 

37 


NOT USED 

21 


NOT USED 

39 


NOT USED 

22 


NOT USED 

40 


NOT USED 

38 


NOT USED 

14 

■■ 

DATA STROBE 

35 


NOT USED 
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PI CONNECTOR 


Table B-6. PI Connector Signal Descriptions (all versions) 


Pin 

Rou A Signal Mnemonic 

Row B Signal Mnemonic 

Row C Signal Mnemonic 

1 

DOO 

BBSY* 

DOS 

2 

D01 

BCLR* 

D09 

3 

002 

ACFAIL* 

010 



BGOIN* 


BGOOUT* 


BGim* 


BGIOUT* 


BG2IN* 


8G20UT* 


BG31N* 


BG30UT* 


BRO* 


BR1* 


BR2* 


BR3* 


AHO 


AMI 


AM2 


AM3 


GNO 


Dll 


012 


D13 


DU 


D15 


GNO 


SYSFAIL* 


BERR* 


SYSRESET* 


LWORO* 


AMS 


A23 


A22 


A21 


A20 


A19 


A18 


A17 


A16 


A15 


A14 


A13 


A12 


All 


AlO 


A09 


AOS 


♦12V DC 


+5V DC 



NOTES; If no signal is referenced, then the Jaguar does not use that pin. A denotes 
an active low signal. 
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APPENDIX C 
ERROR CODES 


The Jaguar Controller Error Codes field returns information pertaining to the operation of the lOPB 
returned in the Command Response Block. Statuses have been separated into five groups: 
ivIACSI/ControUer, General^ Error Recovery, Vh4E, 
status definitions are reported m hexadecimal format. 


T /r'r.-i-r-r.iUf PffTnr VME, uud SCSI ciTors. The V/SCSI 4210 Jaguar controllt 


MACSI/CONTROLLER ERROR CODES 


Hex Code Description 

0x00 GOOD STATUS: 

The controller has completed the command and no errors were detected. The Pass-Back 
status field contains the Pass-Through status. 


0x01 QUEUE FULL: 

TTig yrQrir qijAiig specificd for fhi.g command is fiill and cannot receive another entry. The 
command is not e?^cuted and is moved directly to the Command Response Block with this 
status set The queue can receive another entry after a currently active command has 
completed or if the queue is flushed. 


0x02 WORK QUEUE INITIALIZATION ERROR: 

The work queue specified has not been initialized. The command is not executed and is 
moved directly to the Command Response Block with this status set. The Work Queue 
should be initialized with an Initialize Work Queue Command. 


0x03 FIRST COMMAND ERROR: 

The first command sent to the board was not an Initialize Controller command. The board 
should be reset, and the first command issued should be the Initialize Controller command 
in order to set up the MACSI operating parameters. 

0x04 COMMAND CODE ERROR: 

The command field contains an invalid command type. Either a SCSI lOPB t 3 q)e or a 
Control lOPB type must be specified. 
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0x05 QUEUE NUMBER ERROR; 

The work queue number specified in the Command Queue entry is invalid. Valid work 
queue numbers are 0 to 14. 

0x06 QUEUE ALREADY INmALIZED; 

The work queue specified to be initialized has already been initialized. To re-initialize a 
queue, set the IWQ bit in the options field. 

0x07 QUEUE UNINTTIAUZED: 

An lOPB was issued to a work queue that has not been initialized. Work queues must be 
initialized with operating parameters before usage. 

0x08 QUEUE MODE NOT READY: 

The Start Queue Mode bit was set before the Initialize Controller Command was issued. 
The Initialize Controller Command should be the first board operation after power up to 
configure the MACSI interface. 

0x09 COMMAND UNAVAILABLE; 

The command specified has not been implemented in the current firmware. 

OxOA PRIORITY ERROR: 

The priority specified for the work queue is invalid. 


GENERAL ERROR CODE INFORMATION 


Hex Code Description 

0x10 RESERVED FIELD ERROR; 

A reserved field in the lOPB has non-zero data in it 

0x11 RESET BUS STATUS: 

The SCSI Reset lOPB has executed successfully and generated a Reset on the bus. 

0x12 SECONDARY PORT UNAVAILABLE: 

An lOPB has been issued to the secondary port (Port 1), but the port is not installed. 

0x13 SCSI ID ERROR: 

The SCSI device ID requested is the Jaguar’s own device ID. All devices on the bus require 
unique SCSI IDs. 
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0x14 SCSI BUS RESET STATUS: 

The command could not execute because the SCSI bus is held in the reset state. This may 
be caused by an un-powered device on the bus, improper termination, or an inverted cable. 

0x15 COMMAND ABORTED BY RESET: 

The command has been aborted due to a SCSI reset condition received during execution of 
the command 


0x16 PAGE SI^E ERROR: 

The page size specified in the Page Size field of the Controller Initialization Block is invalid. 
For most applications, this field must be 0. Contact Interphase for special applications. 

0x17 INVALID COMMAND TAG: 

Command tags must be non-zero for successful searches. 

0x18 BUSY COMMAND TAG: 

Command is on the bus. 


VMEbus ERRORS 


Hex Code Description 

0x20 VMEbus BUS ERROR: 

This error indicates that a bus error occurred during the DMA transfer of the data to or 
from the buffer or the bus. 


0x21 VMEbus TIMEOUT; 

This error indicates that bus acquisition was not completed within the programmed timeout 
period This error is typically caused by a nonexistent address or address modifier in the 
lOPB. 


0x23 VMEbus ILLEGAL ADDRESS: 

For 16-bit transfers, the starting address of the VMEbus buffer must fall on a word 
boundary (even address). For 32-bit transfers, the starting address of the VMEbus buffer 
must fall on a long word boundary (multiple of 4). 

0x24 VMEbus ILLEGAL MEMORY TYPE: 

An illegal memory type has been specified 
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0x25 


0x26 


0x27 


0x28 


0x29 


0x2A 


0x2B 


0x2C 


0x2D 


0x2E 


ILLEGAL COUNT SPECIFIED: 

The maximum transfer length specified is not an even number. All transfer counts must be 
even since the controller can oidy perform word or long word transfers. If an odd count is to 
be transferred across the SCSI bus, the count specified in the maximum length field must be 
padded by T’ to round up the VM^us transfer count to a word or long word multiple. 


VMEbus FETCH ERROR: 

A VMEbus error occurred during an ofiboard lOPB fetch. 
VMEbus FETCH TIMEOUT: 

A VMEbus timeout occurred on an oSboard lOPB fetch. 


VMEbus POST ERROR: 

A VMEbus error occurred on an offboard Command Response Block post. 


VMEbus POST TIMEOUT: 

A VMEbus timeout occurred on an ofiboard Command Response Block post. 


VMEbus ILLEGAL FETCH ADDRESS: 
Illegal address on an ofiboard lOPB fetch. 


VMEbus ILLEGAL POST ADDRESS: 

Illegal address on an ofiboard Command Response Block post. 


VMEbus SCATTER/GATHER FETCH: 
VMEbus error on scatter/gather list fetch. 


VMEbus SCATTER/GATHER TIMEOUT: 
VMEbus timeout error on scatter/gather list fetch. 


INVALID SCATTER/GATHER COUNT: 

An invalid munber of scatter/gather elements has been specified. Valid element counts are 
lto64. 
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SCSI ERRORS 

Hex Code 
0x30 

0x31 

0x32 

0x33 

0x34 

0x40 

0x41 

0x42 


Description 

SCSI SELECTION TIMEOUT ERROR: 

The selection phase of the SCSI device has failed The error may occur due to an incorrect 
Target ID. 


SCSI DISCONNECT TIMEOUT ERROR: 

A disconnected device has not re-selected the board in the timeout period This may be 
caused by a hardware error, or a command that may take a very long period of time to 
execute. 

ABNORMAL SCSI SEQUENCE: 

The SCSI operation did not complete successfully due to a hardware error or an abnormal 
operation sequence. 


SCSI DISCONNECT ERROR: 

An invalid SCSI bus sequence has been detected This usually indicates a device has 
disconnected without eitiier issuii^ the disconnect or command complete message. 


SCSI TRANSFER COUNT EXCEPTION: 

The SCSI Transfer Count of Data did not match the couitf specified in the maximum count 
length field The amount of data actually transferred on the SCSI bus will be returned in the 
maximum count leng^ field This status may not be considered an error for commands that 
intentionally allocate more buffer than the SCSI command uses. 


ILLEGAL SCATTER/GATHER COUNT 
Odd byte count in scatter/gather list. 


ILLEGAL SCATTER/GATHER MEMORY TYPE 
Illegal memory type in scatter/gather list 

ILLEGAL SCATTER/GATHER ADDRESS 
Illegal address in scatter/gather list. 
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ERROR HANDLING CODES 


Hex Code Description 


0x50 READ/WRTTE BUFFER COUNT ERROR: 

Buffer count is too large. 

0x51 ILLEGAL READ/WRITE: 

Can’t execute because of offboard Command Response Block. 

0x80 FLUSH ON ERROR IN PROGRESS: 

This status is set when the lOPB is flushed because an error condition has occurred and the 
work queue has the abort enable option set. This causes all queued lOPBs to be flushed 
until the abort acknowledge has been received. 

0x81 FLUSH WORK QUEUE STATUS: 

The queued lOPB is being flushed in response to a Flush Work Queue Command. 

0x82 MISSING COMMAND: 

A device has reselected the 4210 for whidi there is no currently pending command. 

0x83 COUNTER EXHAUSTED: 

The transfer counter has e^diausted but more data is being requested by the target derice. 

0x84 DATA DIRECTION ERROR: 

A data phase is being requested opposite of the the direction set in the lOPB. 


PRINTER PORT ERRORS 


Hex Code Description 

0x90 PRINTER STATUS CHANGE: 

A printer port status change interrupt is being posted. 


0x91 PRINTER COUNT TOO SHORT: 

The value in the Maximum Transfer Length field must be greater than or equal to the 
Printer Transfer Length field. 
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0x92 BAD DATA LENGTH FIELD: 

The Maximum Transfer Length field is set to 0, but the Printer Transfer Length field is not. 

0x93 PRINTER UNAVAILABLE: 

The printer port is not installed or is not initialized. 

0x99 SCATTER/GATHER SELECTED FOR PRINTER PORT: 

Scatter/gather mode is not available for use with the printer port. 

OTHER ERRORS 

Hex Code Description 

OxCO BAD lOPB TYPE: 

The lOPB type field does not match a currently supported lOPB type. 

OxCl lOPB TIMEOUT ERROR 

The lOPB has timed out due to some type of serious error. 
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APPENDIX D 
MACSI DATA STRUCTURES 


/* 

* VJ.struct.h ; V/SCSI 4210 Jaguar MACSI header. 

* 

V 

typedef unsigned char BYTE; /* 8 bit unsigned */ 

typedef unsigned charUBYTE; /* 8 bit unsigned V 

typedef unsigned short UWORD; !* 16 bit unsigned */ 

typedef unsigned int UINT; /* 32 bit unsigned */ 

typedef unsigned int ULONG; /* 32 bit unsigned V 


f**************** Master Control Status Block (MCSB) *******************/ 


typedef struct mcsb { 

/* Master control/Status Block 

*/ 

UWORD 

mcsb_MSR; 

/* Master status register 

*/ 

UWORD 

mcsb_MCR; 

I* Master Control register 

*/ 

UWORD 

mcsb_IQAR; 

/* Interrupt on Queue Available Reg 

*/ 

UWORD 

mcsb_QH0P; 

/* Queue head pointer 

*/ 

UWORD 

nx:sb_THAW; 

!* Thaw work Queue 

*/ 

UWORD 

nicsb_RESO; 

/* Reserved word 0 

*/ 

UWORD 

mcsb_RESl; 

/* Reserved word 1 

*/ 

UWORD 

mcsb_RES2; 

/* Reserved word 2 

*/ 

} VJ MCSB; 




!*************** Controller 

Initialization Block (ciB) *****************/ 

typedef struct cib { 

/* Controller Initialization Block 


UWORD 

cib NCQE; 

/* Number of Comnand Queue Entries 

*f 

UWORD 

cib_BURST; 

/* DMA Burst count 

*/ 

UWORD 

cib NVECT; 

/* Normal Completion Vector 

*/ 

UWORD 

cib EVECT; 

/* Error Completion Vector 

*/ 

UWORD 

cib_PID; 

1* Primary SCSI Bus ID 

*/ 

UWORD 

cib.SID; 

/* Secondary SCSI Bus ID 

*/ 

UWORD 

cib CRBO; 

!* Comnand Response Block Offset 

V 

ULONG 

cib.SELECT; 

/* Selection timeout in milli-second 

V 


ULONG cib_WQ0_TIME0UT; /* Work Q 0 timeout in 256msec ticks */ 

ULONG cib_VME_TIMEOUT: /* VMEbus Timeout 0 * 100msec timeout */ 

ULONG cib_PAGE_SIZE; /* Page size - RESERVED for most applications */ 

UWORD cib_CRB_ADRM00; /* Offboard Comnand Response Block memtype */ 

UINT cib_CRBJ^ODRESS; /* Offboard Comnand Response Block address */ 


UWORD cib_CRB_ERTFUGS; /* Reserved words */ 

} VJ_CIB; 

^**************** Cormand Queue Entry (CQE) *******************/ 

typedef struct cqe { /* Conrond Queue Entry */ 

UWORD cqe_QECR; /* Queue Entry Control Register */ 

UWORD cqe.IOPBJ^OOR; /* lOPB Address */ 

ULONG cqe_CTAG; /* Comnand Tag */ 

UBYTE cqe_IOPB_LENGTH; /* lOPB Length */ 

UBYTE cqe.WORK^QUEUE; /* Work Queue Humber */ 

UWORD cqe_RES0; /* Reserved word */ 

} VJ.CQE; 
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^**************** lOPB Foniiat (lOPB) *******************^ 

typedef struct iopb { 


UWORD 

iopb CMD; 

/* 

IOPB Conmand code 

*/ 

UUORO 

iopb.OPTION; 

/* 

IOPB Option word 

*/ 

UWORD 

iopb_STATUS; 

/* 

IOPB Return Status word 

*/ 

UWORD 

iopb RESO; 

/* 

IOPB Reserved word 

*/ 

U8YTE 

iopb NVCT: 

/* 

IOPB Normal completion Vector 

*/ 

UBYTE 

iopb EVCT; 

/* 

IOPB Error completion Vector 

*/ 

UWORD 

iopb_LEVEL; 

/* 

IOPB Interrupt Level 

*/ 

UWORD 

iopb_RESl; 

/* 

IOPB Reserved word 

*/ 

UWORD 

iopb_ADDR; 

/* 

IOPB Address type and modifier 

*/ 

ULONG 

iopb_BUFF; 

/* 

IOPB Buffer Address 

*/ 

ULONG 

iopb.LENGTH; 

!* 

IOPB Max-Transfer Length 

V 

ULONG 

iopb_SG_LENGTH; 

/* 

IOPB Length in bytes of S/G request 


UWORD 

iopb_RES4; 

/* 

/ 

IOPB Reserved word 

*i 

UWORD 

iopb.UNIT; 

/* 

IOPB Unit address on SCSI bus 

*/ 

UWORD 

iopb_SCSI[6]; 

/* 

IOPB SCSI words for pass through 

*/ 

} VJ.IOPB; 





y**************** Conmand Response Block (CRB) *******************^ 

typedef struct crb { f* Cocmand Response Block */ 


UWORD 

crb CRSW; 

/* Conmand Response Status Word 

*/ ' 


UWORD 

crb RESO; 

/* Reserved word 

* ^ 


ULONG 

crb CTAG; 

/* Conmand Tag 

*/ 


UBYTE 

crb lOPB.LENGTH; 

/* IOPB Length 

*/ 


UBYTE 

crb WORieQUEUE; 

/* Work Queue Number 

*/ 


UWORD 

crb.RESl; 

/* Reserved word 

*1 


VJ_I0PB 

crb_I0PB; 

/* Returned IOPB 

*/ 


} VJ_CRB; 





/**************** Configuration 

Status Block (CSB) *******************j 


typedef struct csb { 

/* Configuration Status Bl(x:k 120 bytes*/ 


UWORD 

csb_RES0; 

/* Reserved word 

*/ 


1IPVTC 

uD i 1 u 

orci . 

/* Reserved byte 

*/ 

/ 


char 

csb_PC00E[3]; 

/* Product Code 

*/ 


UWORD 

csb_RES2; 

/* Reserved word 

*/ 


UBYTE 

csb_RES3; 

/* Reserved byte 

*f 


char 

csb.PVAR; 

/* Product Variation 

*/ 


UWORD 

csb_RES4; 

/* Reserved word 

*/ 


UBYTE 

csb RES5; 

/* Reserved byte 

*/ 


char 

csb_FREV[33 ; 

/* Firmware Revision level 

*/ 


UWORD 

csb_RES6; 

/* Reserved word 

*/ 


char 

csb_FDATE[8]; 

/* Firmware Release date 

*/ 


UWORD 

csb_RES7; 

/* Reserved word 

*/ 


UWORD 

csb.BSIZE; 

/* Buffer size in l^ytes 

*/ 


UWORD 

csb_RES8[2]; 

/* Reserved word 

*/ 


UBYTE 

csb.PIO; 

/* Primary SCSI Bus ID 

*/ 


UBYTE 

csb_SI0; 

/* Secondary SCSI Bus ID 

*/ 


UBYTE 

csb_PRI_SLCTD; 

/* Primary Port (Port 0) Last Device Selected 

*/ 

UBYTE 

csb_SEC_SLCTD; 

/* Secondary Port (Port 1) Last 

Device Selected 

*/ 

UBYTE 

csb_PRI_PSNS; 

/* Primary Port (Port 0) Phase Sense Shadow 

*/ 

UBYTE 

csb_SEC_PSNS; 

/* Secondary Port (Port 1) Phase Sense Shadow 

*/ 

UBYTE 

csb_RSRVD9; 

/* Reserved byte 

*/ 


UBYTE 

csb_0B_I0; 

/* Daughter Board ID 

*/ 


UBYTE 

csb_RSRV010; 

/* Reserved byte 

*/ 


UBYTE 

csbJIP_SW; 

/* Software Dip Switch Setting 

*/ 


UINT 

csb_FRZ_BITS; 

/* Show Which Queues are Frozen 

*/ 


} VJ CSB; 






I**************** Initialize Work Queue Conmand Format (wqcF)**********V 
typedef struct wqcf { /* Initialize Work Queue Conrond Format*/ 


UWORD 

wqcf CMD; 

/* Conmand Normally (0x42) 

*/ 

UWORD 

wqcf.OPTION: 

/* Conmand Options 

*/ 

UWORD 

wqcf_STATUS; 

/* Return Status 

*/ 

UWORD 

wqcf_RES0; 

/* Reserved word 

*/ 

UBYTE 

wqcf NVCT; 

/* Normal Completion Vector 

*/ 

UBYTE 

wqcf^EVCT: 

/* Error Completion Vector 

*/ 

UWORD 

wqcf_ILVL; 

/* Interrupt Level 

*/ 
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Appendix D 


UVORO wqcf_GROUP; /* Number of conmands to group together*/ 


UWORD wqcf_RESl[73; /* Reserved words */ 

UWORO wqcf_WORKQ; /* Work Queue Number */ 

UVORO wqcf_W0PT: /* Work Queue Options */ 

UWORD wqcf_SLOTS; /* Number of slots in the Work Queues */ 

UVORO wqcf_PRIORITY; /* Priority Level V 

UINT wqcf_TIHEOUT; /* Conmand Time-Out for this Queue V 

UVORO wqcf_SEC_WQ; /* Secondary Work Queue Number mirror V 

} VJ_WQCF: 


/**************** OFFBOARD COMMAND QUEUE ENTRY/IOPB ******************^ 

typedef struct offbd_iopb { 

VJ.CQE copycqe; 

VJ_I0PB copyiopb; 

}0FFB0_I0PB; 

/****************** Scatter/Gather Descriptor block ************************/ 
typedef struct { 

UWORD sg_bcount; /* Byte Count for transfer V 

ULONG sg_paddr; /* Physical Address */ 

UWORD sg_addrmod; /* lOPB Address type and modifier */ 

} VJ_SG; 
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